在已经安装nvm的macos、linux或wsl环境中,可把项目确认可用的node.js精确版本写入根目录.nvmrc,再通过nvm install和nvm use安装并切换。把文件与代码一起提交,协作者和新终端按同一文件恢复环境。这里的nvm是nvm-sh维护的posix工具,不是原生windows上的nvm-windows。
先确认当前版本确实适合项目
command -v nvm node --version npm --version cd /path/to/project node --version > .nvmrc cat .nvmrc nvm install nvm use node --version command -v node
先在项目测试通过的版本下执行写入命令。不要把任意终端里当前的旧版本直接当作推荐版本;需要升级时先选择项目支持的目标版本并测试,再更新.nvmrc。nvm是shell函数,检查可用性使用command -v nvm;普通which可能不能按预期找到它。

官方原始README说明版本文件的位置、默认读取及缺失时的行为。
精确版本与移动别名有不同用途
.nvmrc可以使用具体版本,也接受lts/*或node等工具支持的别名。团队需要可重复环境时应保存精确版本;移动别名可能在以后解析到另一个版本。文件应包含一个版本项并以换行结束;用node --version生成会自然带上换行。nvm会向父目录查找文件,因此在子目录执行也要确认它找到的是哪个项目。

.nvmrc的单个版本项、换行和注释规则。
新终端重新选择,依赖另行安装
nvm按当前shell选择版本,写入.nvmrc不代表所有新终端都会自动切换。进入项目后再次执行nvm use;若nvm命令不存在,按已有安装位置加载NVM_DIR中的nvm.sh,再检查shell配置。除非明确安装了对应shell集成,不应声称切换目录就会自动应用。Node版本变化后,按项目锁文件重新安装依赖并运行测试;全局npm包通常也按Node版本分开管理。
将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。
把版本切换纳入团队验证
提交.nvmrc前检查node --version与文件相符,并让CI采用相同版本。运行工具时先确认当前目录和版本,避免在缺少版本文件时依赖nvm exec或nvm run的回退行为。升级失败时可在新分支恢复原.nvmrc并重新选择旧版本;代码和依赖锁文件也应按同一次变更一起回退。










