主题
工具链与环境
git、Node、Java、Maven……开发要用的工具,产品替您检测、安装、维护——已有的不动、缺的一键补、版本全用户一致。
它管哪些工具
| 工具 | 干嘛用的 | 什么时候需要 |
|---|---|---|
| Git | 版本管理 | 提交 / 推送代码 |
| Node.js | 前端运行时 | 前端项目、各类脚本 |
| Java | 后端运行时 | Java 后端项目 |
| Maven | Java 构建工具 | Java 后端项目 |
| uv | Python 运行时管理 | Office 文档生成、部分技能脚本 |
| MCP 运行环境 | 跑 MCP 服务 | 用 MCP 时(见接入与使用 MCP 服务) |
| Chrome for Testing | 实测浏览器 | 浏览器实测(见浏览器实测怎么看) |
| HBuilderX 等 | 移动端编译 | 移动项目(见移动项目从创建到真机) |
检测与一键初始化
打开项目时自动检测(只检测、不安装);缺东西会有提示——点一键初始化环境,按依赖顺序串行装好:
text
Git → Node.js → Java → Maven → uv → MCP 运行环境 → 浏览器- 已装且版本匹配的直接复用——不重复下载(大版本匹配即通过)
- 国内网络自动加速(镜像源)
- 每项独立进度与状态;单项失败不阻断后续,最后统一汇总失败项、可重试初始化
- 装完统一重启服务使环境生效

安全承诺(装过环境的人最关心这个)
- 不删除、不覆盖您已有的工具——已装的 git / node 原样保留
- 不改系统环境变量——PATH 只追加不删改
- 所有安装产物放产品私有目录,与系统工具共存
- 版本标准化——全用户环境一致,「我这里能跑你那里不能」被消除
版本与升级
- 工具版本有标准基线——初始化装的版本是验证过的组合
- 已有工具大版本兼容即用;差太多(如 node 太老)会提示升级路径,您决定动不动
- 换台新电脑:装好产品 → 打开项目 → 一键初始化——同一套版本自动就位
常见卡点
| 现象 | 怎么办 |
|---|---|
| 下载慢 / 卡住 | 网络波动可「重试初始化」续装(已完成的不会重来) |
| 提示版本不匹配 | 看提示的说明——已装工具能用就继续用;要升就让它给升级方案(升级系统工具前它会跟您确认) |
| 公司电脑没管理员权限 | 大部分工具装在产品私有目录(无需管理员);确实装不了的它会给替代建议 |
| 我想用自己的 node / java | 检测到且版本匹配就直接用您的——互不干扰 |
| 初始化到一半关了产品 | 下次打开重新点——已装好的直接跳过 |
延伸阅读
- 第一次使用编程模式:环境初始化在起步流程中的位置
- 出问题了怎么办:环境类报错的总排障入口
- 移动项目从创建到真机:移动端专用工具链(体积更大,按需装)
