dotfiles/BACKUP_INSTRUCTIONS.md

Dotfiles 备份说明

详细备份指南 - 离职前必读

---

📋 目录

1. 备份目的
2. 备份内容
3. 备份步骤
4. 备份后处理
5. 常见问题

---

🎯 备份目的

离职前备份 dotfiles 的目的是：

• ✅ 保留开发环境配置
• ✅ 快速在新机器恢复工作环境
• ✅ 记录已安装的工具和扩展
• ✅ 保存 SSH 公钥（用于新机器授权）

---

📦 备份内容

自动备份（运行 ./setup.sh backup）

项目	说明	敏感性	提交
Brewfile	Homebrew 包列表	公开	✅
SSH 公钥	~/.ssh/*.pub	公开	⚠️
Git 配置	用户信息	敏感	❌
1Password	SSH Agent 配置	敏感	⚠️
VSCode	扩展列表	公开	✅

需要手动备份

• 浏览器书签
• 1Password 紧急工具包
• 其他应用配置

---

🚀 备份步骤

步骤 1: 运行备份脚本

cd ~/.dotfiles
./setup.sh backup

步骤 2: 查看备份报告

# 查看最新的备份报告
ls -lt .backup_report_*.md | head -1 | awk '{print $NF}' | xargs cat

备份报告会显示：

Backup Summary
==========================================
  Items backed up: 5
  Warnings: 0

Files to review:
  ✅ Safe to commit: Brewfile, .1password_config.txt, .vscode_extensions.txt
  ⚠️  DO NOT COMMIT: .git_config_summary.txt, ssh_backup_*/

步骤 3: 查看备份内容

# 查看 Brewfile 变更
git diff Brewfile

# 查看 Git 配置摘要（敏感！看完删除）
cat .git_config_summary.txt

# 查看 SSH 公钥
ls ssh_backup_*/
cat ssh_backup_*/id_ed25519.pub

步骤 4: 提交安全文件

# 只提交安全的文件
git add Brewfile
git commit -m 'backup: update dotfiles before leaving'
git push

步骤 5: 清理敏感文件

# 确认敏感文件已被 .gitignore 排除
git status

# 手动清理（可选）
rm -f .git_config_summary.txt
rm -rf ssh_backup_*/
rm -f .1password_config.txt
rm -f .vscode_extensions.txt
rm -f .backup_report_*.md

---

📝 备份后处理

验证备份完整性

# 1. 检查 Brewfile
head -20 Brewfile

# 2. 备份 SSH 公钥到安全位置
cp ssh_backup_*/id_ed25519.pub ~/Downloads/

# 3. 记录 Git 配置
git config --global user.name
git config --global user.email

保存备份报告

# 将备份报告保存到安全位置（不提交到 git）
cp .backup_report_*.md ~/Downloads/dotfiles-backup-$(date +%Y%m%d).md

---

❓ 常见问题

Q1: 备份会包含我的 SSH 私钥吗？

不会！ 备份只复制 .pub 公钥文件，私钥永远不会被复制或提交。

Q2: 备份文件哪些可以提交到 Git？

文件	是否可提交
Brewfile	✅
.git_config_summary.txt	❌ 包含真实信息
ssh_backup_*/	❌ 公钥也不提交
.1password_config.txt	⚠️ 仅配置说明
.vscode_extensions.txt	✅

Q3: 如何确认敏感文件不会被提交？

# 运行备份后检查
git status

# 如果敏感文件出现在 "Untracked files" 中，说明已被 .gitignore 正确排除

Q4: 备份后多久需要重新备份？

• 定期备份: 每月一次
• 安装新工具后: 立即备份
• 离职前: 必须备份

Q5: 如何验证备份有效？

在新机器或虚拟机上测试：

git clone <your-repo> ~/.dotfiles-test
cd ~/.dotfiles-test
./setup.sh check

---

🔐 安全清单

离职前确认：

• 备份已推送到 GitHub
• 敏感文件已从本地删除
• 已移除旧机器的 GitHub 授权
• 已移除旧机器的 1Password 授权
• 已更新重要账户密码

---

祝你新工作顺利！ 🎉