换电脑不再重装一天：hudo 配置档案一键迁移开发环境

每个开发者都经历过"新电脑日"——兴奋拆箱之后，紧接着就是漫长的环境重建。Git 要配 user.name 和 user.email，Node.js 要选版本，JDK 装完要设 JAVA_HOME，Maven 的 settings.xml 要配阿里云镜像，MySQL 服务要注册……你已经做过三次了，每次都发誓"这次一定记个文档"，然后每次都没记。

这篇文章告诉你：有一种方法，能把旧电脑的开发环境打包成一个文件，到新电脑上一条命令全部恢复。

传统迁移有多痛

认真回忆一下，换电脑时你要做的事：

1. 回忆装了什么——打开旧电脑的 PATH，一个一个翻，发现还漏了几个
2. 逐个下载安装——Git、Node.js、JDK、Go、Python、Maven、Gradle、MySQL、Redis、VS Code……每个都有自己的官网、自己的安装流程
3. 重配环境变量——JAVA_HOME、GOPATH、MAVEN_HOME、GRADLE_HOME，手动在"系统属性"里一条一条加
4. 重写配置文件——Maven 的 settings.xml 要配镜像，Conda 的 .condarc 要换源，Gradle 的 init.gradle 要加仓库
5. 重注册服务——MySQL、PostgreSQL、Redis 都要重新初始化、注册 Windows 服务、设置开机自启
6. 重配 Git 身份——git config --global user.name 和 user.email，忘了的话第一次 commit 就翻车

顺利的话 4-8 小时。不顺利？一整天。

而且最可怕的不是慢，是漏。你可能用了三天才发现 Go 没装，又过一周发现 Redis 服务没注册，直到某天跑项目报错才想起来少了个 MinGW。

hudo 的配置档案：一个文件搞定迁移

hudo 提供了 profile 功能，核心思路很简单：

旧电脑导出一个 .toml 文件 → 拷到新电脑 → 一条命令恢复全部环境。

导出了什么

配置档案会记录：

• 已安装的工具清单和版本（git 2.47.0、nodejs 22.0.0、go 1.23.0……）
• 镜像配置（Maven 阿里云镜像、npm 淘宝源等）
• 版本锁定信息
• Git 全局身份（user.name、user.email）

一个典型的档案文件长这样：

[tools]
git = "2.47.0"
nodejs = "22.0.0"
go = "1.23.0"
jdk = "21.0.4"
maven = "3.9.9"
mysql = "8.4.3"
redis = "5.0.14"
vscode = "1.95.0"

所有信息浓缩成一个几十行的文本文件，U 盘、网盘、邮件随便传。

实战：三步完成环境迁移

第一步：旧电脑导出

hudo profile export

当前目录下会生成 hudo-profile.toml，你的整个开发环境就在这个文件里了。

第二步：新电脑安装 hudo

新电脑上打开 PowerShell，一行命令安装 hudo：

irm hudo.zexa.cc/install.ps1 | iex

第三步：导入档案

把 hudo-profile.toml 拷贝到新电脑，然后执行：

hudo profile import

按提示选择档案文件，hudo 会：

1. 解析档案中的工具列表
2. 显示即将安装的工具，等你确认
3. 批量下载安装所有工具（国内自动走镜像加速）
4. 自动配置所有环境变量（JAVA_HOME、GOPATH、MAVEN_HOME……）
5. 自动注册需要的 Windows 服务（MySQL、PostgreSQL、Redis）
6. 恢复 Git 全局配置

泡杯咖啡回来，环境就好了。

哪些会保留，哪些不会

会保留	不会保留（设计如此）
工具清单和版本号	GitHub CLI 登录令牌
镜像配置	数据库数据
Git user.name / user.email	VS Code 扩展和设置
版本锁定信息

为什么不导出 gh auth token？ 安全考虑。令牌属于敏感凭据，不应该出现在可传输的文件里。导入完成后 hudo 会自动提示你运行 gh auth login 完成认证，几秒钟的事。

VS Code 扩展怎么办？ hudo 安装的是便携版 VS Code，扩展和设置都在 data/ 目录下。你可以直接把旧电脑的 data/ 文件夹复制过来，或者用 VS Code 自带的 Settings Sync 同步。

团队标准化：一份档案统一所有人的环境

配置档案还有一个杀手级用法：团队环境标准化。

技术负责人可以创建一份标准的 hudo-profile.toml，提交到团队仓库：

project-repo/
├── src/
├── hudo-profile.toml   ← 团队标准环境
└── README.md

新人入职，克隆仓库后执行 hudo profile import，5 分钟就拥有和团队一致的开发环境。

再也不会出现这些问题：

• "我本地 JDK 8，你用的 JDK 21，编译不过"
• "你的 Maven 没配镜像，下载依赖卡了半小时"
• "我电脑上跑得好好的啊"——因为每个人的环境变量配得都不一样

总结

传统迁移	hudo 档案迁移
回忆 + 逐个下载 + 手动配置	hudo profile export → 拷文件 → hudo profile import
4-8 小时	10-20 分钟
大概率漏装	完整还原
每次从零开始	一份档案反复使用

下次换电脑，不用再重装一天了。

---

想了解更多？查看 配置档案文档 或直接 安装 hudo 体验。