Windows 上安装 Volta

十月不到底2026-01-16 12:03

一、在 Windows 上安装 Volta

1. 安装 Volta

Windows 官方推荐通过 Windows 安装包安装：

访问 Volta 官网 Releases 页面下载最新 Windows 安装程序：https://github.com/volta-cli/volta/releases

备注：安装过程中确认 Volta 添加到了环境变量 PATH 中。

2. 安装完成后，打开新命令行（PowerShell 或 CMD），验证安装

bash 复制代码

volta --version

如果显示版本号，说明安装成功。

二、安装并设置全局默认 Node 版本（22）

bash 复制代码

volta install node@22
volta default node@22

这样，你打开新的命令行窗口默认 Node 版本就是 22。

三、在项目目录使用指定 Node 14

1. 进入你的项目根目录，执行：

bash 复制代码

volta pin node@14

这条命令会在项目目录创建一个 package.json（如果没有的话），并在其中写入 Volta 配置，固定 Node 版本为 14。

你也可以用下面命令单独生成配置文件，不依赖 package.json：

bash 复制代码

volta pin node@14 --manifest

（一般用 volta pin node@14 即可）

2. （可选）你也可以指定项目里的 npm 版本或 yarn 版本：

bash 复制代码

volta pin npm@6
# 或
volta pin yarn@1

四、使用效果

bash 复制代码

node -v

会显示 Node 14.x 版本。

bash 复制代码

node -v

会显示默认的 Node 22.x 版本。

运行项目启动命令，比如：

bash 复制代码

npm run dev

此时依赖的 Node 版本就是你 pin 的 14 版本。

五、示例操作流程总结

powershell 复制代码

# 确认安装 Volta
volta --version

# 安装并设置默认 Node 版本 22
volta install node@22
volta default node@22

# 进入项目目录
cd path\to\your\project

# 设置项目 Node 版本为 14
volta pin node@14

# 查看当前 Node 版本（应为 14）
node -v

# 跑项目（使用 Node 14）
npm run dev

# 切换到其他目录，查看 Node 版本（应为 22）
cd ..
node -v

六、注意事项

Volta 会自动修改 PATH，确保 Node 和相关工具调用的都是被 pin 版本。
如果你用的是 VSCode，确保关闭所有vscode 后重启，才能切换版本生效。