Dotfiles

我的个人配置文件集合，使用 GNU Stow 进行管理。

📦 包含的配置

• zsh - Z Shell 配置
• nvim - Neovim 编辑器配置
• kitty - Kitty 终端模拟器配置
• hypr - Hyprland 窗口管理器配置
• niri - Niri 滚动窗口管理器配置
• waybar - Waybar 状态栏配置
• rofi - Rofi 应用启动器配置
• starship - Starship 命令行提示符配置
• dunst - Dunst 通知守护进程配置
• mako - Mako 通知守护进程配置

🚀 快速开始

前置要求

确保已安装 GNU Stow：

# Arch Linux
sudo pacman -S stow

# Ubuntu/Debian
sudo apt install stow

# macOS
brew install stow

安装配置

1. 克隆此仓库到你的主目录：

git clone <你的仓库地址> ~/dotfiles
cd ~/dotfiles

2. 使用 stow 安装你需要的配置：

# 安装单个配置
stow zsh
stow nvim
stow kitty

# 或一次性安装所有配置
stow */

3. 重启相应的应用程序以应用配置。

📝 使用说明

Stow 基本命令

# 安装配置（创建符号链接）
stow <package-name>

# 删除配置（删除符号链接）
stow -D <package-name>

# 重新安装配置
stow -R <package-name>

# 模拟运行（查看会做什么而不实际执行）
stow -n <package-name>

# 详细输出
stow -v <package-name>

目录结构

每个配置包都遵循以下结构：

dotfiles/
├── zsh/
│   └── .zshrc
├── nvim/
│   └── .config/
│       └── nvim/
│           └── (配置文件)
└── kitty/
    └── .config/
        └── kitty/
            └── (配置文件)

Stow 会将这些文件符号链接到你的主目录中对应的位置。

🔧 添加新配置

1. 在 dotfiles 目录下创建新的配置包目录
2. 按照目标路径组织文件结构
3. 使用 stow <package-name> 安装

例如，添加 git 配置：

cd ~/dotfiles
mkdir -p git
cp ~/.gitconfig git/.gitconfig
stow git

⚠️ 注意事项

• 在使用 stow 之前，请备份你现有的配置文件
• 如果目标位置已存在文件，stow 会报错。需要先删除或移动现有文件
• 使用 stow -n 可以预览操作而不实际执行，建议先运行查看

🔄 更新配置

配置文件通过符号链接连接，所以：

1. 在此仓库中修改配置文件
2. 更改会立即生效（因为是符号链接）
3. 提交并推送更改到 Git 仓库

cd ~/dotfiles
git add .
git commit -m "更新配置"
git push

🗑️ 卸载配置

如果想移除某个配置的符号链接：

cd ~/dotfiles
stow -D <package-name>

这只会删除符号链接，不会删除仓库中的配置文件。

💡 提示

• 定期备份你的配置文件
• 使用版本控制跟踪配置变更
• 可以为不同的机器创建不同的分支
• 敏感信息（如 SSH 密钥）不应提交到公开仓库

📚 参考资料

• GNU Stow 官方文档
• 使用 Stow 管理 Dotfiles

📄 许可证

MIT License - 自由使用、修改和分享。