CircleCI Node.js项目yml配置文件无法运行问题求助

核心原因 #

你使用的cimg/base:stable是CircleCI的通用基础镜像，默认不包含Node.js运行环境，所以执行node index.js会提示命令未找到。另外，package.json仅用来定义项目依赖，CircleCI不会自动识别它来安装Node.js，所有运行时环境都需要你手动配置。

解决方案 #

方案1：改用CircleCI官方Node.js镜像（推荐）

直接替换为预装Node.js的官方镜像，省去手动安装步骤，更稳定高效：

version: 2.1
executors:
  my-custom-executor:
    docker:
      - image: cimg/node:20  # 可替换为指定版本，如cimg/node:18、cimg/node:latest
        auth:
          username: $DOCKER_HUB_USER
          password: $DOCKER_HUB_PASSWORD
jobs:
  eli5:
    executor: my-custom-executor
    steps:
      - checkout
      - run: npm install  # 若项目有依赖，先安装依赖
      - run: node index.js

workflows:
  my-custom-workflow:
    jobs:
      - eli5 

方案2：在基础镜像中手动安装Node.js

如果必须使用cimg/base:stable，可通过nvm手动安装Node.js：

version: 2.1
executors:
  my-custom-executor:
    docker:
      - image: cimg/base:stable
        auth:
          username: $DOCKER_HUB_USER
          password: $DOCKER_HUB_PASSWORD
jobs:
  eli5:
    executor: my-custom-executor
    steps:
      - checkout
      - run: |
          # 安装nvm并加载环境
          curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
          export NVM_DIR="$HOME/.nvm"
          [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
          # 安装指定版本Node.js（示例为20.x）
          nvm install 20
          nvm use 20
          # 验证安装
          node --version
      - run: npm install  # 安装项目依赖
      - run: node index.js

workflows:
  my-custom-workflow:
    jobs:
      - eli5 

注意事项 #

• 每个run步骤是独立的shell会话，环境变量不会跨步骤保留，所以安装Node.js的命令要放在同一个run块里。
• 优先使用官方Node.js镜像，避免手动安装带来的版本兼容或环境配置问题。

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