dotfiles
Dotfiles for macOS and Ubuntu - configuration files that personalize your development environment
这份 dotfiles 基于 zoumo/dotfiles 并根据个人需求进行了定制和扩展。
更多 dotfiles 参考: GitHub does dotfiles
目录
快速开始
系统准备
如需从全新的 Mac 环境开始，参考 OS X: 如何清除并安装：
- 登出 iCloud 和 iMessage
- 进入恢复模式：
- Apple Silicon (M1/M2/M3等): 关机后长按电源键，直到看到"正在载入启动选项"
- Intel Mac: 重启时按住 Command + R
- 使用磁盘工具抹掉硬盘
- 重新安装 macOS
关于安全擦除：
- Apple Silicon Mac: 使用 APFS 加密卷宗，直接抹掉即可安全删除数据，无需额外擦除
- Intel Mac (HDD): 可选择安全擦除空闲空间
# Intel Mac HDD 安全擦除命令（仅在必要时使用）
diskutil secureErase freespace VALUE /Volumes/DRIVE
# VALUE 说明：
# 0: 单次覆写 0
# 1: 单次随机数覆写
# 2: 7 次覆写
# 3: 35 次覆写
# 4: 3 次覆写
注意：SSD（固态硬盘）不建议频繁擦除，会缩短使用寿命。现代 Mac 基本都使用 SSD，直接抹掉即可。
安装 Xcode
- 更新系统至最新版本
- 从 App Store 安装 Xcode
- 安装 Xcode Command Line Tools
# 方式 1: 命令行安装（推荐）
xcode-select --install
# 方式 2: 输入 gcc 或 git 会自动提示安装
安装 dotfiles
克隆仓库到 ~/.dotfiles 目录：
git clone https://github.com/dubuqingfeng/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
./script/bootstrap
bootstrap 脚本会自动完成以下工作：
- 检查并安装 Homebrew
- 检查并安装 Oh My Zsh
- 链接 dotfiles (
.zshrc, .vimrc, .gitconfig, .gitignore 等)
- 安装 Homebrew packages (binaries, fonts, apps)
- 配置 macOS 系统默认设置
- 安装 Python packages (powerline-status, pyenv 等)
- 美化 vim、ls、terminal (Solarized 配色 + Powerline 状态栏)
安装完成后，需要配置 Homebrew 环境变量：
eval "$(/opt/homebrew/bin/brew shellenv)"
恢复备份
使用 Mackup 恢复应用程序配置：
mackup restore
多设备管理
管理多台设备的配置建议：
- 为不同设备创建分支或使用条件配置
- 使用 Mackup 同步应用程序配置
- 在
.gitignore 中排除设备特定的配置文件
常见问题
问题 1: 连接 raw.githubusercontent.com 失败
curl: (7) Failed to connect to raw.githubusercontent.com port 443
解决方法：配置网络代理或修改 hosts 文件
问题 2: Cargo 环境未找到
.zshenv:.:2: no such file or directory: ~/.cargo/env
解决方法：安装 Rust 工具链
# 方式 1: 使用 Homebrew
brew install rustup
rustup-init
# 方式 2: 官方安装脚本
curl https://sh.rustup.rs -sSf | sh -s -- --no-modify-path -y
使用指南
dotfiles 说明
执行 script/bootstrap 时，脚本会将所有 *.symlink 文件链接到 $HOME 目录：
| Topic | *.symlink | Link Path |
|---|
| vim | vimrc.symlink | ~/.vimrc |
| zsh | zshrc.symlink | ~/.zshrc |
| git | gitconfig.symlink | ~/.gitconfig |
目录结构
采用主题化的目录结构，每个环境配置独立存放：
- bin/: 可执行脚本，会自动添加到 PATH
- topic/*.zsh: shell 启动时自动加载
- topic/path.zsh: 优先加载的路径配置
- topic/*.symlink: 自动链接到
$HOME 目录
macOS 配置
bin/dot 在 script/bootstrap 最后执行，负责安装软件和配置系统。
使用方式：
# 完整安装（默认）- 包含所有软件包和开发环境
dot
# 轻量安装 - 跳过 Python 和 Node.js 环境配置，只安装必要软件
dot light
完整安装执行流程：
os/macos/install.sh - 安装 Homebrew packagesos/macos/set-defaults.sh - 配置 macOS 系统设置pkg/python/install.sh - 配置 Python 环境pkg/node/install.sh - 配置 Node.js 环境os/beautify/install.sh - 美化终端环境
轻量安装执行流程：
os/macos/set-defaults.sh - 配置 macOS 系统设置os/beautify/install.sh - 美化终端环境os/macos/install.sh light - 安装必要的 Homebrew packages
Homebrew packages
在 os/macos/install.sh 中自定义需要安装的软件包：
# 命令行工具
binaries=(
git
tree
wget
...
)
# 字体 (格式: font-XXX)
fonts=(
font-source-code-pro
...
)
# 应用程序
apps=(
iterm2
google-chrome
visual-studio-code
...
)
macOS 系统设置
os/macos/set-defaults.sh 会修改系统默认设置，可根据需求自定义。
主要配置项：
-
性能优化
- 加快窗口 resize 速度
- 加速进入睡眠模式
- 关闭不必要的动画效果
-
触控板/鼠标
- 开启轻触点击
- 开启三指拖拽
- 开启右键菜单
- 提高移动速度
-
键盘
- 开启全键盘控制
- 加快按键重复速度
- 关闭按键长按限制
-
Finder
- 显示隐藏文件
- 显示文件扩展名
- 显示状态栏和路径栏
- 允许文本选择
- 设置默认搜索范围
- 使用列视图
-
Dock
- 窗口最小化到应用图标
- 自动隐藏/显示
- 半透明显示隐藏应用
更多配置参考: Mathias's dotfiles
Mackup 备份
Mackup 用于备份和同步应用程序配置到云端。
工作原理：
将配置文件移动到云盘同步目录（如 ~/Dropbox/Mackup），然后创建符号链接。
安装：
brew install mackup
配置：
创建 ~/.mackup.cfg 文件：
[storage]
engine = dropbox # 支持 dropbox, google_drive, icloud
directory = Mackup # 同步目录名称
[applications_to_sync]
iterm2
oh-my-zsh
sublime-text-3
ssh
[applications_to_ignore]
# 不想同步的应用
自定义应用配置：
在 ~/.mackup/ 目录下创建配置文件（会覆盖默认配置）：
# ~/.mackup/sublime-text-3.cfg
[application]
name = Sublime Text 3