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 以应用更改
安装
- 在 VSCode 扩展商店中搜索 "NVMRC Auto Config"
- 点击安装按钮进行安装
使用方法
创建 .nvmrc 文件
在项目根目录下创建 .nvmrc 文件,内容为指定的 Node.js 版本号,例如:
v18.20.0
或
18.20.0
自动配置
打开项目后,扩展会自动检测 .nvmrc 文件并配置相应的 Node.js 版本
手动配置
可以通过命令面板执行 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}"
}
}
故障排除
版本未找到
- 如果提示版本未找到,请使用
nvm install <version> 命令安装指定版本
- 例如:
nvm install v18.20.0
NVM 未正确安装
- 如果出现
nvm 命令执行错误,请检查 NVM 是否正确安装
- 确保 NVM 在系统 PATH 环境变量中
.nvmrc 格式错误
- 确保
.nvmrc 文件格式为 v18.20.0 或 18.20.0
支持
如果遇到问题或有建议,请:
- 在 GitHub 仓库中提交 Issue
- 或者通过扩展市场反馈问题
版本历史
v1.0.0
- 初始版本
- 支持自动检测和配置 .nvmrc 文件
- 支持 Windows 系统环境变量配置
v1.0.1
许可证
MIT License
| |