nvm或fnm实现多项目node版本隔离，核心是通过工具管理多版本并配合.nvmrc自动切换，确保各项目使用专属node运行时且环境可复现。
多项目 node 版本隔离，核心是让每个项目“自带”它需要的 node.js 运行时，互不干扰。这不是靠手动删装 node，而是靠版本管理工具 + 约定配置实现的自动化、可复现隔离。
用 nvm 或 fnm 管理多版本基础环境
nvm（macOS/Linux）或 nvm-windows（Windows）是成熟方案；fnm（全平台、Rust 编写）速度更快、兼容性更好，2026 年多数新团队已转向 fnm。
- 安装后，可并存多个 Node 版本：比如同时装好 14.21.3、16.20.2、18.20.4、20.15.1
- 每个版本附带独立的 npm、npx 和全局 bin 目录，不会混用全局包
- 切换命令极轻量：
nvm use 16或fnm use 18.20.4，仅影响当前终端会话
通过 .nvmrc 或 .node-version 文件自动绑定项目
在每个项目根目录放一个 .nvmrc（nvm/fnm 支持）或 .node-version（部分工具也识别），内容就一行：
16.20.2
这样，进入项目目录后执行 nvm use 或 fnm use，工具会自动读取并切换到指定版本。配合 shell 配置（如 zsh 的 auto-nvm 插件），甚至能 cd 进目录时自动切换，完全无感。
VS Code 终端与调试器需分别对齐
VS Code 的集成终端默认加载你的 shell 配置（含 nvm/fnm 初始化），所以 nvm use 后终端里 node -v 是对的。但调试器（launch.json）默认走系统 PATH，容易错用旧版 Node。
- 确保
"runtimeExecutable"指向当前项目所用 Node 路径，例如："${env:HOME}/.fnm/versions/v18.20.4/bin/node" - 或统一用
"runtimeVersion": "18.20.4"（需 VS Code 1.85+ 且启用 Node.js 自动发现） - 检查方式：在调试器中打印
process.version，和终端中node -v输出一致才算真正对齐
CI/CD 和 Docker 中延续同一套规则
本地隔离若不能复现到构建环境，就失去意义。推荐做法：
- CI 脚本开头加
fnm install $(cat .nvmrc)+fnm use，保证构建用对版本 - Docker 开发镜像基于
node:20-slim等基础镜像，再预装 fnm，并在构建阶段运行fnm install和fnm default - 避免在 Dockerfile 中硬编码
FROM node:16——那会锁死整个镜像，失去多项目弹性
