Chenhun's Dotfiles (macOS)

这是我的 macOS 配置仓库，使用 软链接 管理 ~/.config 下的各类配置。

---

📦 使用方式

1. 克隆仓库（固定位置）

git clone https://github.com/VesperVei/config_mac.git ~/.myutils/dotfiles

建议使用该路径，后续命令都以这个目录为例。

---

2. 进入仓库并确认配置

cd ~/.myutils/dotfiles
chmod +x setup.sh

执行安装前，建议先检查并按需修改仓库内的配置文件，避免直接覆盖到自己的 ~/.config 使用习惯。

确认后启动交互式安装脚本：

./setup.sh

该脚本会为以下配置创建软链接：

• nvim
• aerospace
• sketchybar
• kitty
• tmux
• yazi

运行脚本后，界面顶部会显示“本次配置清单”：

• 使用 ↑/↓ 或 j/k 移动光标
• 使用空格选中或取消配置项
• 按 1 安装选中的配置项
• 按 2 卸载选中的配置项
• 按 q 退出

仓库中不存在的配置目录会显示为不可选择，并在安装时自动跳过。

---

🔄 更新配置

当仓库有更新时：

cd ~/.myutils/dotfiles
git pull
./setup.sh

重复执行是安全的。

---

🐍 Python 虚拟环境映射（可选）

Neovim 配置支持按项目路径自动切换 Python 虚拟环境。该映射属于本地私有配置，默认不提交到仓库。

如需启用，可参考示例文件创建自己的映射：

cp nvim/lua/chenhun/core/python_venv_map.example.lua nvim/lua/chenhun/core/python_venv_map.lua

然后按需修改：

return {
	["/path/to/project"] = "venv_name",
}

默认虚拟环境根目录是 ~/.virtualenvs。如需自定义，可设置环境变量：

export CHENHUN_PYTHON_VENV_ROOT="/path/to/.venvs"

如果没有创建 python_venv_map.lua，Neovim 也会正常启动，只是不启用项目路径映射。

---

📂 目录结构

dotfiles/
├── setup.sh
├── nvim/
├── aerospace/
├── sketchybar/
├── kitty/
├── tmux/
├── yazi/
└── extras/

---

⚠️ 注意事项

• setup.sh 会在发现真实目录时先备份再创建软链接
• setup.sh 会自动创建 ~/.config，避免首次安装时报目录不存在
• 仓库中不存在的配置目录会自动跳过
• 敏感信息已通过 .gitignore 排除