dotfiles
一套模块化、一键部署的 macOS 开发环境配置方案。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:dotfiles。 它的用途是:一套模块化、一键部署的 macOS 开发环境配置方案。 详细介绍见:https://321skill.com/skills/dotfiles-jasonraimondi/ 请根据该页面的说明完成安装。
使用示例
“我新拿到一台 Mac,想快速配置好和公司电脑一样的开发环境。”,它会引导你执行远程安装命令,并自动完成从系统工具、编程语言到编辑器配置的全套设置。或者
对AI说:“我的 Zsh 插件和别名配置乱了,想恢复成仓库的干净状态。”,它会指导你运行重新创建符号链接的脚本,快速恢复配置。
介绍
这个仓库解决的是开发者在 macOS 上手动配置开发环境繁琐、难以复用和同步的问题。它通过一个远程安装脚本和 GNU Stow 工具,将复杂的 shell 配置、软件包安装、语言版本管理等自动化,实现从零到一快速搭建统一且可移植的开发环境。
使用方式非常直接:只需执行仓库提供的远程安装命令,然后运行 setup.sh 脚本即可。整个过程会自动处理 Homebrew 软件安装、Zsh 配置、Git 设置等,并通过符号链接将配置模块化地管理在用户目录下。
它非常适合需要在多台 Mac 设备间保持开发环境一致性的开发者,尤其是全栈开发、运维工程师或经常重装系统、更换设备的用户。对于追求效率、希望开箱即用并深度定制 shell 环境的程序员来说,这是一个极佳的选择。
需要注意的是,此方案深度绑定 macOS 和 Homebrew 生态,不适用于 Linux 或 Windows 用户。初次使用后,务必按照指引配置 Git 用户信息和 SSH 密钥。对于私有化配置,建议使用提供的自定义文件,避免直接修改被版本控制的配置文件。
核心特点
与同类 dotfiles 方案相比,它深度集成了 mise(替代 asdf/rbenv 等)进行多语言版本管理,并通过分类清晰的 Brewfile(如 Requirefile, CaskfileQuicklook)实现更精细的 Homebrew 软件包控制。同时,它采用 Prezto 作为 Zsh 框架,提供了比 Oh My Zsh 更轻量、更快的 shell 体验。
注意事项
仅适用于 macOS 操作系统,不适合 Linux 或 Windows 用户。
常见问题
如何在 Windows 上使用这个配置?
无法直接使用,该方案专为 macOS 和 Homebrew 设计。
安装后如何添加自己的私有配置?
编辑 ~/.zsh/99-custom.zsh 文件,该文件不会被 Git 跟踪。