nodejs-version-setup

nodejs-version-setup

在运行任何 Node.js 命令前，为此仓库设置并验证正确的 Node.js 运行时。

使用时机

每当任务需要运行 Node.js 工具时都使用此技能，包括 npm、pnpm、yarn、npx、构建脚本、测试、代码检查工具或本地 CLI。

说明

1. 按以下顺序检测所需的 Node.js 版本：
   • .nvmrc
   • .node-version
   • package.json -> engines.node
2. 按以下顺序检测已安装的版本管理器：
   • nvm
   • fnm
   • asdf
   • volta
3. 使用第一个可用的管理器选择所需版本：
   • nvm：nvm install 和 nvm use
   • fnm：fnm install 和 fnm use
   • asdf：asdf install nodejs <version> 和 asdf local nodejs <version>
   • volta：volta install node@<version>
4. 如果不存在版本文件，但存在 engines.node，则在该范围内确定一个具体版本，并使用检测到的管理器安装或启用它。
5. 如果没有可用的管理器，请检查当前的 node -v 是否满足所需版本。如果不满足，请停止并询问用户是否确认安装版本管理器或手动继续。
6. 执行项目命令前验证运行时：
   • node -v
   • npm -v（或根据项目使用 pnpm -v / yarn -v）
   • which node，以确认当前使用的二进制文件路径
7. 在任务输出中报告版本的定义来源（例如 .nvmrc）、使用的管理器以及最终的 node -v。
8. 在完成版本选择和验证前，不要运行依赖安装、构建、测试或 CLI 脚本。