开发环境配置恢复与影响评估指南

背景: 本文档详细说明了通过 system_backup_helper.py 脚本备份的数据在重装系统后如何恢复，以及如果丢失这些配置可能产生的影响。

备份数据位置示例: backup_data_YYYYMMDD_HHMMSS 文件夹

1. 核心开发环境恢复

🔐 SSH 密钥 (ssh 目录)

• 备份内容: id_rsa, id_rsa.pub, known_hosts 等。
• 恢复方法:
  1. 安装 Git 后，打开 Git Bash 或终端。
  2. 将备份的 ssh 目录下的所有文件复制到用户主目录的 .ssh 文件夹中：
     • Windows: C:\Users\YourName\.ssh\
  3. 重要: 确保私钥文件 (id_rsa) 的权限正确（通常仅限当前用户读取）。
• 丢失影响: 🔴 高危
  • 无法连接 GitHub/Gitee/GitLab 等代码托管平台。
  • 需要重新生成密钥对 (ssh-keygen)。
  • 必须登录所有相关平台（GitHub, Gitee, 服务器等）删除旧公钥并上传新公钥，过程繁琐。

⚙️ Git 全局配置 (git 目录)

• 备份内容: .gitconfig
• 恢复方法:
  • 将 .gitconfig 文件复制到用户主目录 C:\Users\YourName\。
• 丢失影响: 🟡 中等
  • 提交代码时 Git 会提示设置 user.name 和 user.email。
  • 丢失自定义的 Git 别名 (alias) 和差异对比工具配置，需重新设置。

📦 Node.js / NPM / Yarn (dev_env 目录)

• 备份内容: .npmrc, .yarnrc, npm_global 配置。
• 恢复方法:
  • 将 .npmrc 和 .yarnrc 复制到用户主目录。
  • 如果备份了 npm_global 配置文件，视情况恢复到 AppData\Roaming\npm\etc。
• 丢失影响: 🟡 中等
  • 镜像源丢失: npm install 速度变慢，需重新设置淘宝源/公司私有源。
  • Auth Token 丢失: 如果配置了私有仓库的 Token，需重新登录 (npm login)。

☕ Maven / Java (dev_env/maven 目录)

• 备份内容: settings.xml
• 恢复方法:
  • 复制到 C:\Users\YourName\.m2\ 目录下。
• 丢失影响: 🟡 中等
  • 无法下载依赖（如果依赖于阿里云镜像或公司私服）。
  • 需重新配置镜像源地址。

2. 工具与软件配置恢复

☁️ PicGo 图床 (tools/picgo 目录)

• 备份内容: data.json
• 恢复方法:
  1. 安装 PicGo。
  2. 运行一次 PicGo 让其初始化文件夹。
  3. 关闭 PicGo。
  4. 将备份的 data.json 覆盖到 C:\Users\YourName\AppData\Roaming\picgo\data.json。
• 丢失影响: 🔴 高危
  • 密钥丢失: 丢失 OSS/S3/七牛云的 AccessKey 和 SecretKey。
  • 需登录云服务商控制台重新创建密钥。
  • 丢失历史上传记录配置，需重新配置存储桶名称和自定义域名。

📂 Navicat 数据库连接 (tools/navicat_profiles 目录)

• 备份内容: profiles 文件夹下的 .ndm 或 .json 文件。
• 恢复方法:
  1. 安装 Navicat。
  2. 找到 Navicat 的配置存储位置（通常在 Documents\Navicat\Premium\profiles 或安装目录）。
  3. 将备份的文件复制进去，或在 Navicat 中使用“导入连接”功能（视版本而定，通常直接覆盖文件即可生效）。
• 丢失影响: 🔴 高危
  • 连接丢失: 所有保存的数据库连接信息（IP、端口、用户名）丢失。
  • 密码丢失: 虽然 Navicat 加密保存密码，但文件丢失意味着需要重新输入所有数据库密码。如果不记得密码，将非常麻烦。

📝 VS Code / Trae / Cursor (editors 目录)

• 备份内容: settings.json, keybindings.json, snippets。
• 恢复方法:
  • VS Code: 复制到 C:\Users\YourName\AppData\Roaming\Code\User\。
  • Trae: 复制到 C:\Users\YourName\AppData\Roaming\Trae\User\。
• 丢失影响: 🟡 中等
  • 编辑器回到默认状态，字体、主题、格式化规则丢失。
  • 自定义快捷键失效，影响编码效率。
  • 代码片段 (Snippets) 丢失，需重新编写。

⚡ FTPRush (tools/ftprush 目录)

• 备份内容: XML 配置文件。
• 恢复方法:
  • 安装 FTPRush 后，使用其“导入配置”功能，或直接覆盖 AppData\Roaming\FTPRush 下的同名文件。
• 丢失影响: 🟡 中等
  • 丢失所有保存的 FTP 站点信息（服务器地址、账号、密码）。

🚀 Postman (tools/postman 目录)

• 备份内容: Partitions, Local Storage 等数据文件夹。
• 恢复方法:
  • 安装 Postman 并关闭。
  • 将备份内容覆盖到 C:\Users\YourName\AppData\Roaming\Postman\。
• 丢失影响: 🟡 中等
  • 如果未登录 Postman 账号，本地 Collection 和 Environment 可能会丢失。
  • 登录账号通常会同步云端数据，但本地设置和未同步的草稿可能丢失。

🤖 Android 开发 (dev_env/android 目录)

• 备份内容: adbkey, adbkey.pub。
• 恢复方法:
  • 复制到 C:\Users\YourName\.android\。
• 丢失影响: 🟡 中等
  • 连接以前授权过的测试手机时，会再次弹出“允许 USB 调试”的确认框。通常影响较小，但在自动化测试场景下可能导致连接失败。

3. 软件清单的使用

• 文件: installed_software_list.txt
• 用途:
  • 重装系统后，打开此文本文件。
  • 逐行检查，去官网下载并安装您需要的软件。
  • 这是一个“备忘录”，防止您忘记安装某些平时不常用但在特定场景下必需的工具（如 360zip, ScreenToGif, Postman 等）。

4. 总结：评估矩阵

资产名称	恢复难度	丢失后果	建议备份等级
SSH Keys	困难	无法拉取/推送代码，需多平台重置公钥	⭐⭐⭐⭐⭐ (必须)
PicGo 配置	中等	无法上传图片，需重置云服务密钥	⭐⭐⭐⭐⭐ (必须)
Navicat 连接	困难	丢失所有数据库入口，找回密码极耗时	⭐⭐⭐⭐⭐ (必须)
Git/NPM 配置	容易	开发环境报错，需重新配置源	⭐⭐⭐⭐ (建议)
编辑器设置	容易	编码体验下降，需花时间调教	⭐⭐⭐ (建议)
软件清单	容易	忘记安装某个工具，用到时才发现	⭐⭐ (辅助)

建议: 请务必将生成的 backup_data 文件夹复制到移动硬盘或网盘中。仅保存在本地磁盘（如果未分盘或格式化全盘）是不安全的！