Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>NVMRC Auto ConfigNew to Visual Studio Code? Get it now.
NVMRC Auto Config

NVMRC Auto Config

towerlau

| (1) | Free
不同项目中使用不同Node.js版本;Using Different Node.js Versions Across Different Projects
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

NVMRC Auto Config 扩展

介绍

本插件是指定当前项目的Node.js版本,不影响全局Node.js版本,本插件的开发旨在解决不同项目中使用不同Node.js版本,且这些使用不同Node.js版本的项目可同时运行

NVMRC Auto Config 是一个 VSCode 扩展,旨在自动配置项目中的 Node.js 版本。该扩展会监听项目根目录中的 .nvmrc 文件,并根据文件中指定的 Node.js 版本来配置 VSCode 终端环境,确保项目使用正确的 Node.js 版本运行。

  • 必须安装 NVM (Node Version Manager),并确保 NVM 在系统 PATH 环境变量中;
  • 项目中必须存在 .nvmrc 文件,文件内容可以先不填写

功能

  • 自动检测:监听工作区中的 .nvmrc 文件变化
  • 版本配置:根据 .nvmrc 文件自动配置 Node.js 版本
  • 环境变量设置:将正确的 Node.js 路径添加到终端环境变量中
  • 智能提示:当指定的 Node.js 版本未安装时,提供安装提示
  • VSCode 重启:配置完成后可选择重启 VSCode 以应用更改

安装

  1. 在 VSCode 扩展商店中搜索 "NVMRC Auto Config"
  2. 点击安装按钮进行安装

使用方法

  1. 创建 .nvmrc 文件 在项目根目录下创建 .nvmrc 文件,内容为指定的 Node.js 版本号,例如:

    v18.20.0
    

    或

    18.20.0
    
  2. 自动配置 打开项目后,扩展会自动检测 .nvmrc 文件并配置相应的 Node.js 版本

  3. 手动配置 可以通过命令面板执行 nvmrc-auto-config.configureAndRestart 命令手动触发配置

命令

  • nvmrc-auto-config.configureAndRestart:手动配置 Node.js 版本并可选择重启 VSCode

要求

  • 已安装 NVM (Node Version Manager)
  • Windows 系统 (当前版本主要针对 Windows)

配置

扩展会自动在项目 .vscode/settings.json 文件中添加以下配置:

{
  "terminal.integrated.env.windows": {
    "PATH": "NVM中指定版本的Node路径;${env:PATH}"
  }
}

故障排除

  1. 版本未找到

    • 如果提示版本未找到,请使用 nvm install <version> 命令安装指定版本
    • 例如:nvm install v18.20.0
  2. NVM 未正确安装

    • 如果出现 nvm 命令执行错误,请检查 NVM 是否正确安装
    • 确保 NVM 在系统 PATH 环境变量中
  3. .nvmrc 格式错误

    • 确保 .nvmrc 文件格式为 v18.20.0 或 18.20.0

支持

如果遇到问题或有建议,请:

  1. 在 GitHub 仓库中提交 Issue
  2. 或者通过扩展市场反馈问题

版本历史

v1.0.0

  • 初始版本
  • 支持自动检测和配置 .nvmrc 文件
  • 支持 Windows 系统环境变量配置

v1.0.1

  • 做了一些优化

许可证

MIT License

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2026 Microsoft