feat: add new article on automating macOS development environment with dotfiles

Author: fullstackjam

content/2025/我的Dotfiles项目：现代化开发环境自动化配置.md

@@ -0,0 +1,266 @@
++++
+title = "我的 Dotfiles 项目：现代化开发环境自动化配置"
+date = "2025-10-15"
+description = "分享我的 macOS 开发环境自动化配置项目，从手动配置到一键部署的演进历程"
+tags = ["dotfiles", "automation", "development", "macos", "devops"]
++++
+
+作为一名开发者，我们经常面临一个问题：换电脑时需要重新配置开发环境。从安装各种工具、配置终端、设置 Git、到配置编辑器，这个过程既繁琐又容易出错。为了解决这个痛点，我创建了一个自动化的 dotfiles 项目，让我能够在几分钟内完整重建我的开发环境。
+
+## 项目背景
+
+每当我需要在新机器上工作时，总是要花费大量时间来重新配置环境：
+
+- 安装 Homebrew 和各种开发工具
+- 配置 Zsh 和 oh-my-zsh
+- 设置 Git 配置和 SSH 密钥
+- 配置 Neovim 编辑器
+- 安装各种 GUI 应用程序
+
+这个重复的过程不仅浪费时间，还容易遗漏某些重要配置。因此，我决定创建一个全自动化的 dotfiles 项目来解决这个问题。
+
+## 项目设计理念
+
+### 模块化设计
+
+我的 dotfiles 项目采用了模块化的设计思想，将整个安装过程拆分为独立的模块：
+
+```
+dotfiles/
+├── Makefile              # Make targets for modular installation
+├── Brewfile              # Homebrew packages and casks
+├── scripts/              # Modular installation scripts
+│   ├── common.sh         # Shared functions and utilities
+│   ├── 01-homebrew.sh    # Install Homebrew
+│   ├── 02-brewfile.sh    # Install packages from Brewfile
+│   ├── 03-git-crypt.sh   # Setup and unlock git-crypt
+│   ├── 04-ssh.sh         # Setup SSH directory and permissions
+│   ├── 06-oh-my-zsh.sh   # Install oh-my-zsh
+│   ├── 07-stow.sh        # Create symbolic links with stow
+│   └── install-all.sh    # Run all scripts in sequence
+├── zsh/.zshrc           # Zsh configuration
+├── git/.gitconfig       # Git configuration
+└── nvim/.config/nvim/   # Neovim configuration
+```
+
+这种模块化设计带来了诸多好处：
+
+- **选择性安装**：可以只运行需要的组件
+- **错误隔离**：一个步骤失败不会影响其他步骤
+- **易于调试**：可以单独测试各个组件
+- **灵活性**：可以跳过不适用的步骤
+
+### 一键安装体验
+
+虽然支持模块化安装，但我也提供了一键安装的体验：
+
+```bash
+git clone https://github.com/fullstackjam/dotfiles ~/dotfiles
+cd ~/dotfiles
+make all
+```
+
+这一条命令就能完成整个开发环境的配置。
+
+## 核心技术实现
+
+### 使用 GNU Stow 管理配置文件
+
+我使用 GNU Stow 来管理配置文件的符号链接。Stow 是一个优雅的解决方案，它可以：
+
+- 保持home目录的整洁
+- 自动处理目录创建和链接
+- 支持版本控制
+- 轻松同步多台机器的配置
+
+```bash
+# 使用 stow 创建符号链接
+for dir in */; do
+    if [ -d "$dir" ] && [ "$dir" != ".ssh/" ] && [ "$dir" != "scripts/" ]; then
+        stow --target="$HOME" --restow "$dir"
+    fi
+done
+```
+
+### 智能的依赖管理
+
+项目使用 Makefile 来管理依赖关系，确保安装步骤按正确顺序执行：
+
+```makefile
+all: homebrew brewfile git-crypt ssh oh-my-zsh stow
+
+homebrew:
+    @scripts/01-homebrew.sh
+
+brewfile: homebrew
+    @scripts/02-brewfile.sh
+
+git-crypt: brewfile
+    @scripts/03-git-crypt.sh
+
+ssh: git-crypt
+    @scripts/04-ssh.sh
+```
+
+### 安全性考虑：Git-crypt 加密
+
+对于敏感的配置文件（如 SSH 密钥），我使用 git-crypt 进行加密：
+
+```bash
+# 检查并解锁加密文件
+if [ -f "$DOTFILES_DIR/git-crypt-key" ]; then
+    if git-crypt status | grep -q "encrypted"; then
+        git-crypt unlock "$DOTFILES_DIR/git-crypt-key"
+    fi
+fi
+```
+
+这确保了敏感信息在公开仓库中的安全性。
+
+## 包含的工具和配置
+
+### 命令行工具
+
+我的 Brewfile 包含了完整的开发工具链：
+
+**基础 CLI 工具**：
+- `git`, `zsh`, `stow`, `nvim`
+- `curl`, `wget`, `jq`, `yq`, `tree`, `htop`
+- `fzf`, `ripgrep`, `fd` 等现代化替代工具
+
+**开发工具**：
+- `kubectl`, `helm` (Kubernetes 生态)
+- `pyenv`, `pyenv-virtualenv` (Python 版本管理)
+- `nvm` (Node.js 版本管理)
+- `awscli`, `opentofu` (云原生工具)
+
+**Shell 增强**：
+- `zsh-syntax-highlighting`
+- `zsh-autosuggestions`
+
+### GUI 应用程序
+
+同时也自动安装常用的 GUI 应用：
+
+```ruby
+# GUI applications
+cask "warp"                # 现代化终端
+cask "visual-studio-code"  # 代码编辑器
+cask "cursor"              # AI 代码编辑器
+cask "notion"              # 笔记工具
+cask "typora"              # Markdown 编辑器
+cask "1password"           # 密码管理
+cask "orbstack"            # Docker Desktop 替代
+```
+
+### 配置文件详解
+
+#### Zsh 配置
+
+我的 `.zshrc` 配置包含了：
+
+```bash
+# oh-my-zsh 主题和插件
+ZSH_THEME="robbyrussell"
+plugins=(git kubectl helm pyenv)
+
+# 实用别名
+alias ll='ls -alF'
+alias gs='git status'
+alias k='kubectl'
+alias py='python3'
+
+# 自定义函数
+mkcd() {
+    mkdir -p "$1" && cd "$1"
+}
+```
+
+#### Git 配置
+
+包含了现代化的 Git 配置，支持更好的颜色显示、别名和合并工具。
+
+#### Neovim 配置
+
+提供了基础但功能完善的 Neovim 配置：
+
+```vim
+" 基本设置
+set number relativenumber
+set autoindent smartindent
+set tabstop=4 shiftwidth=4 expandtab
+
+" 搜索设置
+set ignorecase smartcase
+set incsearch hlsearch
+
+" 键位映射
+let mapleader = " "
+nnoremap <leader>w :w<CR>
+nnoremap <leader>h :nohlsearch<CR>
+```
+
+## 安装流程设计
+
+### 错误处理和用户体验
+
+每个脚本都包含了完善的错误处理和用户反馈：
+
+```bash
+# 彩色输出函数
+print_status() {
+    echo -e "${GREEN}=== $1 ===${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+```
+
+### 状态检查
+
+提供了 `make status` 命令来检查当前配置状态：
+
+```bash
+make status
+# 输出示例：
+# === Dotfiles Setup Status ===
+# Homebrew: ✅ Installed
+# git-crypt: ✅ Installed
+# SSH setup: ✅ Linked
+# Git config: ✅ Linked
+# Zsh config: ✅ Linked
+```
+
+### 清理和恢复
+
+还提供了清理功能，可以安全地移除所有符号链接：
+
+```bash
+make clean
+# 移除符号链接并恢复备份
+```
+
+## 使用体验
+
+新机器配置只需要三步：
+
+```bash
+git clone https://github.com/fullstackjam/dotfiles ~/dotfiles
+cd ~/dotfiles
+make all
+```
+
+整个过程 10-15 分钟完成，无需人工干预。配置同步也很简单：提交更改到仓库，其他机器拉取后重新运行 `make stow` 即可。
+
+## 总结
+
+这个项目将半天的手动配置工作压缩到一条命令，确保了跨机器环境的一致性。所有配置都在版本控制下，可以随时回滚。
+
+如果你也经常需要配置开发环境，建议创建自己的 dotfiles 项目。
+
+项目地址：https://github.com/fullstackjam/dotfiles