Windows开发环境配置指南
本文介绍 Windows 系统下开发环境的快速搭建，涵盖 Node.js 版本管理（nvm-windows）和 Python 包管理器（uv）的安装与使用。
# 一、nvm-windows 安装
nvm-windows 是 Windows 平台下的 Node.js 版本管理器，可以方便地在多个 Node.js 版本之间切换。
# 1. 下载安装包
访问 GitHub Release 页面下载最新版本：
https://github.com/coreybutler/nvm-windows/releases
下载 nvm-setup.exe 安装程序。
# 2. 安装步骤
- 双击运行
nvm-setup.exe - 选择安装路径（建议默认，或自定义到非中文、非空格路径）
- 选择 Node.js 符号链接路径（用于切换版本时自动创建的 node 快捷方式）
- 等待安装完成
# 3. 验证安装
打开新的命令行窗口（CMD 或 PowerShell），执行：
nvm version
若显示版本号，则安装成功。
# 4. 配置镜像源（可选，国内推荐）
找到 nvm 安装目录下的 settings.txt 文件（默认路径 C:\Users\<用户名>\AppData\Roaming\nvm\settings.txt），添加以下内容：
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
2
或在命令行执行：
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/
2
# 二、nvm-windows 安装 Node.js 与切换版本
# 1. 查看可用版本
查看所有可安装的 Node.js 版本：
nvm list available
查看已安装的版本：
nvm list
# 2. 安装指定版本
安装最新 LTS 版本：
nvm install lts
安装指定版本：
nvm install 20.10.0
nvm install 18.19.0
2
# 3. 切换 Node.js 版本
切换到指定版本：
nvm use 20.10.0
切换后验证：
node -v
npm -v
2
# 4. 设置默认版本
nvm-windows 没有 alias default 命令（这是 Linux/macOS 版本的语法）。
方式一：使用 nvm use 后保持
执行 nvm use 20.10.0 后，该版本会被记录，下次打开终端仍为该版本（除非手动切换）。
方式二：添加到启动脚本（可选）
若希望每次打开终端自动切换到指定版本，可在 PowerShell 配置文件中添加：
# 编辑 PowerShell 配置文件
notepad $PROFILE
# 添加以下内容
nvm use 20.10.0
2
3
4
5
# 5. 卸载版本
nvm uninstall 18.19.0
# 6. 常见问题
问题：切换版本时报错 exit status 1
解决方案：
- 以管理员身份运行命令行
- 确保 Node.js 符号链接路径有写入权限
- 关闭所有使用 Node.js 的程序后再切换
问题：npm 命令找不到
切换版本后会自动关联 npm，若仍找不到，重新安装该版本的 Node.js：
nvm uninstall 20.10.0
nvm install 20.10.0
nvm use 20.10.0
2
3
# 三、Python 安装
# 方式一：官网安装包（推荐新手）
# 1. 下载安装包
访问 Python 官网下载页面：
https://www.python.org/downloads/windows/
选择最新的稳定版本，下载 Windows installer (64-bit)。
# 2. 安装步骤
- 双击运行安装程序
- 重要：勾选
Add Python to PATH（将 Python 添加到环境变量） - 选择
Install Now或自定义安装路径 - 等待安装完成
# 3. 验证安装
python --version
pip --version
2
# 方式二：Microsoft Store（简单快捷）
- 打开 Microsoft Store
- 搜索
Python - 选择所需版本（如 Python 3.12）并安装
# 方式三：使用 winget（命令行安装）
# 搜索可用版本
winget search Python.Python
# 安装指定版本
winget install Python.Python.3.12
2
3
4
5
# 配置 pip 镜像源（国内推荐）
临时使用：
pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple
永久配置：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 四、uv 安装
uv 是 Astral 开发的超快速 Python 包管理器，用 Rust 编写，速度比 pip 快 10-100 倍。
# 1. 安装 uv
# 方式一：PowerShell 安装（推荐）
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 方式二：pip 安装
pip install uv
# 方式三：下载二进制文件
从 GitHub Releases 下载：
https://github.com/astral-sh/uv/releases
将下载的 uv.exe 放入 PATH 环境变量目录。
# 2. 验证安装
uv --version
# 3. uv 常用命令
# 安装包
# 安装单个包
uv pip install requests
# 从 requirements.txt 安装
uv pip install -r requirements.txt
# 安装开发依赖
uv pip install pytest --dev
2
3
4
5
6
7
8
# 创建虚拟环境
# 创建虚拟环境
uv venv
# 指定 Python 版本创建
uv venv --python 3.12
# 激活虚拟环境（Windows CMD）
.venv\Scripts\activate
# 激活虚拟环境（PowerShell）
.venv\Scripts\Activate.ps1
2
3
4
5
6
7
8
9
10
11
# 其他常用命令
# 查看已安装的包
uv pip list
# 卸载包
uv pip uninstall requests
# 导出依赖
uv pip freeze > requirements.txt
# 同步依赖（确保环境与 requirements.txt 一致）
uv pip sync requirements.txt
2
3
4
5
6
7
8
9
10
11
# 4. uv 项目管理（新功能）
uv 还支持项目级别的依赖管理：
# 初始化新项目
uv init my-project
cd my-project
# 添加依赖
uv add requests
# 移除依赖
uv remove requests
# 运行脚本
uv run python main.py
2
3
4
5
6
7
8
9
10
11
12
# 5. 配置镜像源
# 临时使用
uv pip install requests --index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 永久配置（环境变量）
setx UV_INDEX_URL https://pypi.tuna.tsinghua.edu.cn/simple
2
3
4
5
# 五、总结
| 工具 | 用途 | 安装方式 |
|---|---|---|
| nvm-windows | Node.js 版本管理 | exe 安装包 |
| Node.js | JavaScript 运行时 | 通过 nvm 安装 |
| Python | 编程语言 | 官网安装包 / winget / Microsoft Store |
| uv | Python 包管理器 | PowerShell 脚本 / pip |
# 推荐开发环境
Node.js: 20.x LTS（通过 nvm-windows 管理）
Python: 3.12.x（官网安装）
包管理: uv（替代 pip，速度更快）
2
3