\r \r

NVM 自动切换\r

\r 根据 package.json 的 engines 字段自动切换到正确的 Node.js 版本。\r \r

使用场景\r

\r

• 进入 Node.js 项目目录\r
• 设置新的开发环境\r
• Node 版本不匹配错误\r
• CI/CD 流水线设置\r \r

快速开始\r

\r

Windows\r

# 自动获取当前目录\r
.\scripts\
vm-auto-switch.ps1\r
\r
# 或指定项目路径\r
.\scripts\
vm-auto-switch.ps1 [项目路径]\r
```\r
\r
### macOS / Linux\r
```bash\r
# 自动获取当前目录\r
./scripts/nvm-auto-switch.sh\r
\r
# 或指定项目路径\r
./scripts/nvm-auto-switch.sh [项目路径]\r
```\r
\r
## 工作原理\r
\r
1. **检测操作系统** - 识别 Windows、macOS 或 Linux\r
2. **自动获取项目路径** - 如未提供路径，自动使用当前工作目录\r
3. **检查当前 Node 版本** - 获取当前激活的 Node.js 版本\r
4. **检查/安装 NVM** - 如未安装则自动安装\r
5. **读取 package.json** - 解析 engines.node 字段\r
6. **对比版本** - 如果当前版本已满足要求，跳过切换\r
7. **查找/安装 Node** - 使用现有版本或下载匹配版本\r
8. **切换版本** - 激活正确的 Node 版本\r
\r
## 工作流程\r
\r
```\r
获取项目路径（参数或当前目录）\r
↓\r
检查当前 Node 版本\r
↓\r
读取 package.json engines.node\r
解析版本要求 (例如 >=14.0.0)\r
↓\r
当前版本已满足要求？\r
├── 是 → 跳过切换，提示当前版本兼容\r
│\r
└── 否 → 继续\r
    ↓\r
    检查 NVM 是否已安装？\r
    ├── 否 → 自动安装 NVM\r
    │   ├── Windows: 下载 nvm-setup.exe\r
    │   └── macOS/Linux: 运行安装脚本\r
    │\r
    └── 是 → 继续\r
        ↓\r
        查找匹配的已安装版本？\r
        ├── 是 → nvm use \x3C版本号>\r
        │\r
        └── 否 → nvm install \x3C最新匹配版本>\r
            nvm use \x3C版本号>\r
```\r
\r
## 脚本\r
\r
`scripts/` 目录下的工具脚本：\r
\r
| 脚本 | 平台 | 用途 |\r
|------|------|------|\r
| `nvm-auto-switch.ps1` | Windows | PowerShell 实现 |\r
| `nvm-auto-switch.sh` | macOS/Linux | Bash 实现 |\r
\r
## 示例\r
\r
**当前目录（自动获取）：**\r
```bash\r
./scripts/nvm-auto-switch.sh\r
```\r
\r
```powershell\r
.\scripts\
vm-auto-switch.ps1\r
```\r
\r
**指定项目：**\r
```bash\r
./scripts/nvm-auto-switch.sh /path/to/project\r
```\r
\r
```powershell\r
.\scripts\
vm-auto-switch.ps1 "C:\projects\my-app"\r
```\r
\r
## 注意事项\r
\r
- Windows 需要管理员权限来安装 nvm\r
- macOS/Linux 需要 curl 来安装 nvm\r
- 支持版本前缀：`^`, `~`, `>=`, `\x3C=` 等\r
- 安装 nvm 后可能需要重启终端\r
- 不提供路径参数时，自动使用当前工作目录\r