dotfiles

一套用于快速同步和部署个人开发环境配置文件的工具集。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:dotfiles。
它的用途是:一套用于快速同步和部署个人开发环境配置文件的工具集。
详细介绍见:https://321skill.com/skills/dotfiles-0xkahi/
请根据该页面的说明完成安装。

使用示例

“我新拿到一台 Mac 开发机,想快速部署我的 Zsh、Git 和 Neovim 配置。”,它会引导你克隆这个仓库,运行 `stow .` 和 `./scripts/symlinks.sh --create` 命令,几分钟内就能还原你熟悉的工作环境。

介绍

这个仓库主要解决了开发者在多台机器间同步和部署个人配置文件(如 shell、编辑器、Git 等配置)时,手动复制粘贴效率低下且容易出错的问题。

它通过两个核心步骤来使用:首先,利用 stow 工具将仓库中的配置文件自动符号链接到系统的 ~/.config 目录下,实现配置的集中管理。其次,通过一个自定义的 symlinks.sh 脚本,处理那些需要直接放置在用户主目录(如 .zshrc)的配置文件,弥补了 stow 默认行为的不足。

这套工具非常适合需要频繁切换工作环境(如公司电脑、个人笔记本、远程服务器)的开发者、运维工程师或任何对终端和开发工具有深度定制需求的用户。它让环境搭建从小时级缩短到分钟级。

使用前建议先阅读仓库内的 Brew Setup 文档以确保系统依赖已安装。对于 Linux 用户,还提供了专门的 setup.sh 脚本。请注意,部分配置(如特定的 tmux 主题)可能需要手动安装,仓库中已有明确指引。

核心特点

与仅使用 Stow 的配置方案相比,它额外提供了专门处理主目录配置文件的 symlink 脚本,解决了 Zsh 等 shell 配置的部署痛点;同时,它整合了从 Git 全局忽略文件到 Linux 环境初始化的完整流程,提供了开箱即用的环境配置解决方案。

注意事项

不适合只想管理单一工具配置或对命令行操作不熟悉的用户。

常见问题

如何在 Mac 上使用这个仓库?

首先使用 Homebrew 安装所需依赖(如 stow),具体可参考仓库内的 Brew Setup 文档,然后再运行 stow 和 symlinks 脚本。

如何卸载或取消链接这些配置文件?

运行 `./scripts/symlinks.sh --delete` 可以删除主目录的符号链接,使用 stow 的删除命令(如 `stow -D .`)可以取消 `~/.config` 下的链接。