创建新repo时Node.js版本自动降级至10.x的问题如何解决？

问题触发原因排查 #

• 确认是否安装了nvm、fnm这类Node版本管理工具，这类工具默认支持进入含.nvmrc、.node-version配置文件的目录时自动切换版本。如果创建的新repo继承了模板的低版本配置文件，就会触发自动降级到10.x。
• 检查系统全局Node默认版本，在非项目目录下执行node -v确认版本是否为14.8，如果全局默认本身是10.x，新创建的repo没有单独指定版本时就会继承全局版本。
• 检查创建repo所用的脚手架/模板配置，是否在package.json的engines字段中强制指定了node >=10.x <14的版本范围，部分预置模板会携带该配置，触发版本管理工具自动切换到符合要求的最低版本。

对应解决方法 #

• 版本管理工具自动切换场景：
  • 修改版本管理工具的全局默认版本，nvm执行nvm alias default 14.8，fnm执行fnm default 14.8，设置后无特殊版本配置的所有目录都会默认使用14.8版本。
  • 可以在常用的工作根目录下新增.nvmrc文件，写入内容14.8，后续进入该目录下的所有子目录（包括新创建的repo）如果没有单独指定版本，就会默认沿用14.8版本。
• repo模板配置限制场景：
  • 自定义模板的话直接修改预置配置，删除低版本限制，或者把engines字段的Node版本要求调整为>=14.8即可。
  • 用第三方模板的话，每次创建完repo后手动修改对应版本配置，避免后续进入目录再次触发自动切换。
• 临时应急方案：如果同时存在需要使用10.x版本的项目，无需修改全局配置，在需要用14.8的repo目录下手动执行对应版本管理工具的切换命令（如nvm的nvm use 14.8），即可临时切换当前目录的Node版本。

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