Windows 开发环境一键配置器
这是什么
专治换电脑 / 重装系统后，装环境装到怀疑人生。
用户说"我要配 Python + Node + Git 的开发环境"或"帮我配个前端开发环境"，本 skill 输出：
- 安装清单：要装什么、去哪下、装哪个版本（含官方下载地址）
- 配置脚本：环境变量、PATH、镜像源加速、常用全局包
- 验证清单：装完逐项检查，确认真的能用
一句话：把"装环境"从两小时的摸索，变成照着清单走的二十分钟。
何时使用
- "新电脑，帮我把开发环境配好"
- "重装系统了，Python/Node/Git 都要重新装"
- "帮我检查下我电脑上开发环境缺什么"
- "PATH 配错了，命令找不到"
- "pip/npm 下载太慢，帮我配国内镜像"
核心工作流
第 1 步：环境体检（先诊断再动手）
跑 scripts/env_check.py 扫描当前机器：
- 已装哪些运行时（Python/Node/Java/Go/Rust/Git/Docker...）及版本
- PATH 里有哪些关键路径、有没有缺失
- 包管理器镜像源是官方还是国内
- 输出体检报告：✅已有 / ⚠️版本过低 / ❌缺失
第 2 步：生成安装方案
按用户的技术栈方向，给出精确到版本和下载地址的清单：
| 技术栈 | 需要装的 |
|---|---|
| Python 后端 | Python 3.11+、pip 镜像、virtualenv、Git |
| 前端 | Node.js LTS、npm/pnpm 镜像、Git、VS Code |
| Java | JDK 17、Maven、配置 JAVA_HOME、Maven 镜像 |
| Go | Go 1.21+、配置 GOPATH/GOPROXY |
| 全栈 | 上述组合 + Docker Desktop |
第 3 步：环境变量配置（给命令，不手工点）
提供命令行配置方法（比手工点图形界面可靠、可复现）：
# 永久设置用户级环境变量(无需管理员)
[Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Java\jdk-17", "User")
# 追加 PATH(不覆盖已有)
$old = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$old;C:\new\path", "User")
第 4 步：镜像源加速（国内必配）
# pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# npm
npm config set registry https://registry.npmmirror.com
# Maven (settings.xml 阿里云镜像)
# Go
go env -w GOPROXY=https://goproxy.cn,direct
第 5 步：验证（装完必须验）
python --version && pip --version
node --version && npm --version
java -version && mvn -version
git --version
每一项都要真的出版本号，才算装好。
环境体检脚本
scripts/env_check.py 一键扫描（只读，不改任何配置）：
python env_check.py
输出示例：
[环境体检报告] 2026-09-09
✅ Python 3.11.4 (C:\Python311\python.exe)
✅ Node v20.11.0
❌ Java 未安装
⚠️ Git 2.39.1 (建议升级到 2.42+)
-----------------------------------
缺失 1 项, 建议升级 1 项
常见问题速查
| 问题 | 原因 | 解决 |
|---|---|---|
| 装完命令仍"不是内部或外部命令" | PATH 未生效 | 重开终端；或 refreshenv；检查是否装到用户级而非系统级 |
| pip 装包报 SSL 错误 | 网络/证书问题 | 配国内镜像 + --trusted-host |
| 多个 Python 版本冲突 | PATH 顺序 | 用 where python 查看优先级；推荐用 py -3.11 指定 |
| npm 全局包装完找不到命令 | 全局路径不在 PATH | npm config get prefix 查路径，加入 PATH |
| JAVA_HOME 配了但 Maven 不认 | 变量值多了分号/引号 | JAVA_HOME 指向 JDK 根目录，不加 bin、不加分号 |
安全边界（必须遵守）
- ✅ 只配置用户自己的开发环境，所有命令可审计、可撤销
- ✅ 环境变量默认设用户级（
User），不动系统级，避免影响其他用户 - ✅ 安装软件只给官方下载地址，不提供破解/非授权渠道
- ❌ 不做：修改系统目录、绕过 UAC 提权、写入系统级 PATH 影响全局
- ❌ 不做：下载/执行来源不明的安装包或一键脚本
输出规范
- 体检报告（先跑脚本，基于真实情况，不臆测）
- 安装清单（表格：软件 / 版本 / 官方地址 / 是否必需）
- 配置命令（可复制的 PowerShell/Bash 命令，含注释）
- 验证清单（逐条命令 + 预期输出）
- 常见问题（针对用户环境的具体坑）
示例
> 用户：新电脑，我要做 Python 后端开发
正确输出：
1. 先跑 env_check.py 看现状
2. 清单：Python 3.11(官网/微软商店)、Git、VS Code、pip 镜像
3. 命令：装 Python 勾选 Add to PATH → 配 pip 镜像 → 建 venv
4. 验证：python --version、pip --version、git --version
5. 提醒：不要用系统 Python 装包，先建虚拟环境
