Windows 开发环境搭建

这页适合作为“新电脑或重装系统后的开发机初始化清单”。真正决定后续效率的不是装了多少工具，而是包管理器、运行时、终端、编辑器和 WSL 是否按顺序搭好。

推荐最小清单

如果你只想先把机器拉到可开发状态，最小组合通常够用：

• 包管理器：Winget + Scoop
• 终端：Windows Terminal
• 编辑器：VS Code
• 版本控制：Git
• 运行时：Node.js / Python / Rust（按需）
• Linux 环境：WSL

先把这一套跑顺，再补 Docker、数据库客户端、API 工具和美化组件。

第一步：包管理器

推荐同时安装 Winget（系统自带）和 Scoop：

# 安装 Scoop（CLI 工具推荐用 Scoop）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
scoop bucket add extras

第二步：基础工具

# 安装 Windows Terminal（Win10 需要，Win11 自带）
winget install Microsoft.WindowsTerminal

# 安装 PowerToys
winget install Microsoft.PowerToys

# 安装 7-Zip
scoop install 7zip

第三步：开发工具

# 编辑器
winget install Microsoft.VisualStudioCode

# 版本控制
winget install Git.Git

# 容器
winget install Docker.DockerDesktop

第四步：运行时环境

Node.js 版本管理建议三选一：

• fnm：轻量、启动快，适合只想要 Node 版本切换的用户
• Volta：更适合纯 Node.js / 前端工具链，详见 Volta Node 版本管理
• mise：更适合同时管理 Node、Python、Rust、Go 等多语言环境，详见 mise 多语言版本管理

不建议把多个 Node 版本管理器同时作为主入口长期混用。

# Node.js 版本管理
winget install Schniz.fnm
fnm install 22
fnm default 22

# 或使用 Volta（Node 生态优先）
winget install Volta.Volta
volta install node@22
volta install pnpm

# 或使用 mise（多语言统一管理）
winget install jdx.mise
mise use -g node@22
mise use -g pnpm@latest

# 包管理器
npm install -g pnpm

# Bun
powershell -c "irm bun.sh/install.ps1 | iex"

# Python
winget install Python.Python.3.12
winget install astral-sh.uv

# Rust
winget install Rustlang.Rustup

第五步：终端美化

# Oh My Posh
winget install JanDeDobbeleer.OhMyPosh
oh-my-posh font install CascadiaCode

第六步：WSL

wsl --install

第七步：Git 配置

git config --global user.name "[name]"
git config --global user.email "[email]"
git config --global init.defaultBranch main
ssh-keygen -t ed25519 -C "[email]"

第八步：VS Code 扩展

必装扩展：

• Error Lens
• GitLens
• Vue - Official
• Prettier
• UnoCSS
• Docker
• WSL
• rust-analyzer

可选工具

winget install Postman.Postman
winget install DBBrowserForSQLite.DBBrowserForSQLite
winget install Insomnia.Insomnia

推荐初始化顺序

更稳的机器初始化顺序通常是：

1. 先装包管理器和终端
2. 再装 Git 与编辑器
3. 再装运行时与版本管理器
4. 再配置 Git、SSH 和常用扩展
5. 最后再装 Docker、数据库工具、API 客户端和美化组件

先保证“能写代码、能拉仓库、能跑项目”，再追求桌面和终端体验会更省时间。

常见问题

Node.js 到底选 fnm、Volta 还是 mise

• 只想管理 Node：fnm
• 前端与 Node 工具链优先：Volta
• 想统一管理 Node、Python、Rust、Go：mise

最好只选一个作为主入口，避免同类工具长期混用。

为什么终端里命令装好了却找不到

高频原因通常是：

• PATH 没刷新
• 多个版本管理器同时接管了同一运行时
• 终端和 VS Code 使用的 shell / 环境不一致

WSL 和 Windows 两边都装运行时可以吗

可以，但最好明确哪边是主开发环境。否则很容易出现：

• Git 配置两套
• Node / Python 版本不一致
• SSH 密钥和依赖装在不同侧

风险提醒

• 版本管理器不要贪多，Node 一套主入口就够
• Docker、WSL、Git、SSH 建议尽早规划主工作流
• 大型项目如果准备放进 WSL，尽量别再长期从 C: 盘跨文件系统操作

延伸阅读

• 本地开发环境搭建
• VS Code 配置指南
• WSL 安装与配置
• 终端配置与美化

进阶：一键安装脚本

将以下内容保存为 setup-dev.ps1，一次性安装所有开发工具：

$packages = @(
    "Microsoft.WindowsTerminal",
    "Microsoft.PowerToys",
    "7zip.7zip",
    "Microsoft.VisualStudioCode",
    "Git.Git",
    "Docker.DockerDesktop",
    "Schniz.fnm",
    "pnpm.pnpm",
    "Python.Python.3.12",
    "astral-sh.uv",
    "Rustlang.Rustup",
    "JanDeDobbeleer.OhMyPosh"
)

foreach ($pkg in $packages) {
    Write-Host "Installing $pkg..." -ForegroundColor Cyan
    winget install $pkg --accept-package-agreements --accept-source-agreements
}

Write-Host "All dev tools installed!" -ForegroundColor Green

powershell -ExecutionPolicy Bypass -File setup-dev.ps1

参考链接

• Windows Terminal — GitHub
• PowerToys — GitHub
• fnm — GitHub
• Volta — Node 工具链管理
• mise — 多语言版本管理
• Oh My Posh — 官网
• Docker Desktop — 官网