Auto NVM - 自动 Node 版本管理
🚀 Auto NVM 是一个智能的 VS Code 扩展，能够自动检测项目中的 .nvmrc 文件并智能管理 Node.js 版本。当您打开包含 .nvmrc 文件的项目时，扩展会自动检查并提示安装或切换到指定的 Node.js 版本。
✨ 主要特性
🔍 智能检测
- 自动检测工作区中的
.nvmrc 文件
- 监听文件变化，实时响应配置更新
- 支持精确版本号和主版本号匹配
🎯 智能版本匹配
- 支持精确版本匹配（如
18.20.7）
- 支持主版本匹配（如
v18 自动匹配最高的 18.x.x 版本）
- 优先使用已安装的匹配版本，避免重复下载
🛡️ 安全的安装流程
- 不会自动下载，需要用户确认后执行
- 在集成终端中透明执行
nvm install 命令
- 提供详细的安装进度和状态反馈
⚡ 便捷操作
- 快捷键
Ctrl+Alt+N 手动触发检查
- 自动在 VS Code 启动时检查当前项目
- 一键重新检查版本状态
📋 系统要求
- VS Code: 1.103.0 或更高版本
- NVM: 需要预先安装 nvm (Linux/macOS) 或 nvm-windows (Windows)
- Node.js: 通过 nvm 管理的 Node.js 环境
🚀 快速开始
1. 安装扩展
在 VS Code 扩展市场搜索 "Auto NVM" 并安装。
2. 创建 .nvmrc 文件
在项目根目录创建 .nvmrc 文件：
v18
或指定精确版本：
18.20.7
3. 自动检测
打开包含 .nvmrc 的项目，扩展会自动：
- 检查当前 Node 版本
- 如果版本不匹配，提示安装或切换
- 如果版本未安装，提供安装选项
🎮 使用方法
自动模式
扩展会在以下情况自动触发：
- VS Code 启动完成后
- 打开新的工作区文件夹
.nvmrc 文件发生变化
手动模式
- 使用快捷键
Ctrl+Alt+N
- 或通过命令面板执行 "load node" 命令
安装流程
当检测到需要安装新版本时：
确认对话框
需要安装Node版本 v18，是否在终端中执行以下命令？
nvm install v18
[确认执行] [取消]
执行安装
- 点击"确认执行"后，在集成终端自动执行安装命令
- 实时显示安装进度和状态
安装完成
- 提供"重新检查版本"按钮
- 或使用
Ctrl+Alt+N 重新检查
⚙️ 扩展设置
当前版本不需要额外配置，开箱即用。
🔧 支持的 .nvmrc 格式
# 主版本号（推荐）
v18
18
# 精确版本号
18.20.7
v18.20.7
# 次要版本号
18.20
v18.20
🐛 已知问题
- Windows 用户需要确保 nvm-windows 已正确安装并配置
- 某些企业网络环境可能影响 Node.js 下载速度
📝 更新日志
0.0.1 (初始版本)
- ✅ 自动检测
.nvmrc 文件
- ✅ 智能版本匹配和安装提示
- ✅ 集成终端安装流程
- ✅ 快捷键支持 (
Ctrl+Alt+N)
- ✅ 实时文件监听
- ✅ 安全的用户确认机制
Working with Markdown
You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
- Split the editor (
Cmd+\ on macOS or Ctrl+\ on Windows and Linux)
- Toggle preview (
Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux)
- Press
Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets
Enjoy!
| |
