2026年2月14日 星期六
##
GN:
nvm:已安装,node未安装。
Python:3.6。
WN:
OM:
版本管理工具
对于尚未安装 Node.js 和 Python 的 Windows 新电脑来说,想要方便快捷地安装并管理这两个环境,最推荐的方式是使用专门的版本管理工具。它们能让你像换衣服一样,在不同项目所需的版本之间轻松切换,避免各种环境冲突的烦恼。
这里为你梳理了三种主流且高效的工具方案,你可以根据自己的喜好和需求来选择。
| 方案 | 核心工具 | 主要特点 | 适用人群 |
|---|---|---|---|
| 一站式方案 | CVM (Cross-platform Version Manager) | 一个工具同时管理Node.js和Python,还支持PHP,非常统一。 | 喜欢简洁、希望用一个工具搞定所有语言环境管理的开发者。 |
| 经典组合方案 | NVM (Node Version Manager) + UV | NVM 是Node.js版本管理的事实标准,稳定可靠;UV 是Python生态的新星,速度极快,功能强大。 | 追求工具成熟度和未来趋势,希望在各自语言领域使用最专业工具的开发者。 |
| Python单飞方案 | Pyenv-win + UV | Pyenv-win 专一管理Python版本;UV 负责包管理和项目环境。 | 主要进行Python开发,偶尔需要Node.js环境的开发者。 |
考虑到你是新电脑且希望“方便快捷”,我个人最推荐方案二(NVM + UV),这套组合足够经典、强大,能很好地覆盖你未来绝大多数的开发场景。
下面,我就以这个方案为例,为你整理一份详细的环境搭建指南。
环境搭建实操指南 (以NVM + UV为例)
1. 安装 Node.js 版本管理工具 (NVM)
这是管理Node.js的第一步,也是最关键的一步。
- 安装前准备:如果你的电脑之前从未安装过Node.js,这一步可以跳过。如果曾安装过,请务必先通过“控制面板” -> “程序和功能”将其彻底卸载,以避免路径冲突。
- 下载与安装:
- 访问 NVM for Windows 的官方GitHub发布页面:https://github.com/coreybutler/nvm-windows/releases。
- 下载最新版本的
nvm-setup.zip安装包。 - 解压并运行
nvm-setup.exe。在安装过程中,建议将安装路径修改为一个简单且不含空格和中文的目录,例如C:\nvm。后续的Node.js符号链接路径保持默认即可。
- 配置镜像加速(国内用户强烈推荐):
- 打开NVM的安装目录(如
C:\nvm),找到并编辑settings.txt文件。 - 在文件末尾添加以下两行,将下载源替换为淘宝镜像,速度会快很多:
node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/
- 打开NVM的安装目录(如
- 验证安装:
- 打开一个新的 PowerShell 或 命令提示符 窗口(这一步很重要,目的是重新加载环境变量)。
- 输入
nvm -v,如果能看到版本号,说明安装成功。
2. 使用 NVM 安装 Node.js
现在,你就可以通过NVM来安装任何你需要的Node.js版本了。
- 查看可用版本:在终端中输入
nvm list available,可以看到所有可供下载的Node.js版本列表。 - 安装最新LTS版本:LTS(长期支持版)是大多数项目最稳妥的选择。输入
nvm install --lts。 - 安装指定版本:例如,如果你需要安装Node.js 16版本,可以输入
nvm install 16.14.2或直接nvm install 16(安装该大版本下的最新版)。 - 使用已安装的版本:安装后,需要“使用”它才能生效。输入
nvm use 16.14.2,将当前终端会话切换到该版本。 - 验证Node.js和npm:分别输入
node -v和npm -v,如果正确输出版本号,则Node.js环境就准备就绪了。
3. 安装 Python 环境管理工具 (UV)
UV 是一个用Rust编写的极速Python包安装器和项目管理器,它也内置了安装和管理Python版本的功能。
- 安装 UV:UV 的安装不依赖于Python本身。在 PowerShell 中直接运行以下命令即可:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" - 验证安装:安装完成后,重新打开一个终端,输入
uv --version,确认安装成功。
4. 使用 UV 安装 Python
接下来,让UV帮你安装Python。
- 查看可安装的Python版本:输入
uv python list,会列出所有UV可以安装的Python版本。 - 安装指定版本的Python:例如,安装Python 3.12,可以输入
uv python install 3.12。 - 创建虚拟环境:Python项目强烈建议使用虚拟环境来隔离依赖。在项目目录下,输入
uv venv --python 3.12,UV就会创建一个包含Python 3.12的虚拟环境(.venv文件夹)。 - 在虚拟环境中管理包:激活虚拟环境后(Windows下一般是运行
.venv\Scripts\activate),就可以使用uv pip install requests这样的命令来安装项目所需的包了,所有包都会被隔离在这个环境中。
一些小建议
- 关于PowerShell执行策略:在后续使用中,如果你在PowerShell里遇到“因为在此系统上禁止运行脚本”的错误,可以以管理员身份打开PowerShell,执行
set-executionpolicy remotesigned命令(选择“是”)来解决。 - 项目级配置:对于Node.js项目,可以在根目录创建一个
.nvmrc文件,里面写上你需要的Node.js版本号(如16.14.2)。这样,团队成员进入项目后只需执行nvm use,NVM就会自动切换到正确的版本。 - 保持工具更新:可以定期检查NVM(
nvm version)和UV(uv --version)的版本,适时更新以获取新功能和修复。
这套方案帮你从零搭建了一个干净、灵活且强大的开发环境。如果在安装过程中的任何一步遇到问题,比如命令执行报错或者版本切换不成功,随时可以把具体的错误信息发给我,我们一起看看怎么解决。
作者:李世民 创建时间:2026-02-14 19:41
最后编辑:李世民 更新时间:2026-02-14 19:47
最后编辑:李世民 更新时间:2026-02-14 19:47