.dotfiles

一套跨平台、高度定制化的开发环境配置管理工具集。

安装使用

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

帮我安装这个 AI Skill:.dotfiles。
它的用途是:一套跨平台、高度定制化的开发环境配置管理工具集。
详细介绍见:https://321skill.com/skills/dotfiles-janbiasi/
请根据该页面的说明完成安装。

使用示例

“我刚拿到一台新的MacBook,需要快速搭建我的开发环境。”,它会指导你克隆这个仓库,并运行`make configure-macos`和`make install-brew`来一键设置系统偏好并安装所有开发工具。或者,当你换到Linux机器时,可以说“帮我在Arch Linux上配置我的工作环境”,它会引导你使用`make install-arch`和`make install-aur`来安装所需软件。

介绍

这个仓库解决了开发者在多台机器或不同操作系统(如macOS和Arch Linux)上,快速、一致地搭建和同步个人开发环境的痛点。它通过GNU Stow进行符号链接管理,将复杂的配置文件(dotfiles)模块化,实现一键部署和更新。

使用方式非常清晰:克隆仓库后,针对不同操作系统(如macOS或Arch Linux)执行对应的make命令即可完成基础配置和软件包的安装。例如,在macOS上运行make configure-macosmake install-brew,就能自动化完成系统偏好设置和Homebrew软件安装。

它非常适合追求效率、希望环境配置可移植且可版本控制的开发者,特别是全栈开发、运维工程师等需要频繁切换或重建工作环境的角色。对于有特定工具链偏好(如使用zed编辑器、starship提示符、atuin历史记录)的用户,能极大提升效率。

需要注意的是,这套配置高度个性化,直接使用前建议仔细阅读其包含的模块(如aerospace窗口管理、karabiner键位映射),并酌情修改以适应自己的习惯。同时,它依赖特定的包管理器(如Homebrew、yay),在非macOS或Arch系Linux上可能需要手动适配。

核心特点

核心区别在于其清晰的跨平台支持(macOS与Arch Linux采用不同的Shell和安装流程)以及高度模块化的配置管理,通过Makefile提供了从系统配置、软件安装到环境秘密管理的完整自动化工作流,而非简单的配置文件集合。

注意事项

不适合不熟悉命令行、或所用操作系统/发行版不在其支持范围(如Windows或非Arch的Linux发行版)的用户直接开箱即用。

常见问题

如何在非macOS/Arch Linux系统上使用?

需要手动适配安装命令和软件包管理器,核心的Stow配置管理部分仍可参考。

如何添加自己的配置模块?

在仓库根目录创建同名文件夹,放入配置文件,然后通过`stow`命令或仓库的Makefile任务进行链接。