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,这一步可以跳过。如果曾安装过,请务必先通过“控制面板” -> “程序和功能”将其彻底卸载,以避免路径冲突。
  • 下载与安装
    1. 访问 NVM for Windows 的官方GitHub发布页面:https://github.com/coreybutler/nvm-windows/releases
    2. 下载最新版本的 nvm-setup.zip 安装包。
    3. 解压并运行 nvm-setup.exe。在安装过程中,建议将安装路径修改为一个简单且不含空格和中文的目录,例如 C:\nvm。后续的Node.js符号链接路径保持默认即可。
  • 配置镜像加速(国内用户强烈推荐)
    1. 打开NVM的安装目录(如 C:\nvm),找到并编辑 settings.txt 文件。
    2. 在文件末尾添加以下两行,将下载源替换为淘宝镜像,速度会快很多:
      node_mirror: https://npmmirror.com/mirrors/node/
      npm_mirror: https://npmmirror.com/mirrors/npm/
  • 验证安装
    1. 打开一个新的 PowerShell命令提示符 窗口(这一步很重要,目的是重新加载环境变量)。
    2. 输入 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 -vnpm -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