如何为Rails应用按项目单独指定所需Node版本？

完全可以实现和.ruby-version逻辑一致的项目级Node版本隔离，不会出现修改单个项目Node版本时篡改全局版本的问题，主流Node版本管理工具都原生支持该能力。全局版本被意外改动的本质，是使用了无隔离能力的全局Node安装/切换方式。

常用实现方案 #

1. 适配性最广：nvm #

nvm是目前生态最通用的Node版本管理工具：

• 先卸载之前直接通过系统包管理器、官方安装包全局安装的Node，避免路径优先级冲突导致隔离失效
• 安装nvm后，全局默认Node版本通过nvm alias default <版本号>设置，该版本仅在无项目级配置的目录下生效
• 进入目标Rails项目根目录，执行echo "20.10.0" > .nvmrc（将20.10.0替换为当前项目需要的Node版本号）
• 可配置shell钩子实现进入目录自动读取.nvmrc切换版本，也可以进入项目后手动执行nvm use触发切换，整个过程只会在当前项目目录的shell会话中生效，完全不会改动全局默认Node版本

2. 体验对齐rbenv：nodenv #

如果平时用rbenv管理Ruby版本，nodenv的使用逻辑几乎完全一致，学习成本为0：

• 安装nodenv后，全局Node版本通过nodenv global <版本号>设置
• 进入项目根目录执行nodenv local 18.18.0（替换为项目所需版本号），会自动在根目录生成.node-version文件，格式和.ruby-version完全一致
• 不需要额外配置手动切换命令，只要进入项目目录，nodenv会自动读取.node-version配置加载对应Node版本，全程不会修改全局配置

3. 高性能轻量方案：fnm #

fnm是基于Rust开发的轻量版本管理工具，启动速度远快于nvm，同时兼容.nvmrc和.node-version两种配置文件：

• 全局默认版本通过fnm default <版本号>设置
• 项目根目录下的.nvmrc/.node-version写入对应版本号后，配置好shell自动切换钩子，进入目录就会自动切到匹配版本，不会影响全局配置

注意事项 #

• 一定要清理干净系统路径下直接安装的全局Node二进制文件，否则shell会优先加载全局Node，导致版本隔离失效
• 项目根目录的版本声明文件可以提交到Git仓库，团队成员拉取代码后只要使用支持该配置的版本管理工具，就能自动对齐Node版本，避免环境不一致问题
• 安装项目npm依赖前，先确认当前已经切换到项目对应的Node版本，避免依赖被安装到全局Node的模块目录下

内容的提问来源于stack exchange，提问作者stevec