Windows下CircleCI CLI执行circleci local execute build报错Err: Not found

• 确认Docker运行状态
  CircleCI CLI本地执行依赖Docker Desktop，先确保Docker Desktop处于运行状态，执行docker ps验证Docker命令能正常返回结果，排除Docker未启动的问题。

• 修正命令格式
  方式1的命令缺少--job参数，正确的执行命令应为：

  circleci local execute --job build
  

  原命令未指定--job标识，CLI无法识别build为目标job，这很可能是触发"Not Found"错误的直接原因。

• 检查配置文件路径
  方式2生成process.yml时，确保当前工作目录为项目根目录，或使用绝对路径指定config.yml。执行circleci local execute时，也要确认process.yml在当前目录，或通过-c参数指定完整路径：

  # 生成process.yml时使用绝对路径示例
  circleci config process D:\projects\your-repo\.circleci\config.yml > process.yml
  # 执行时指定process.yml路径
  circleci local execute -c D:\projects\your-repo\process.yml --job build
  

• 更新CircleCI CLI到最新版本
  执行circleci version查看当前版本，若版本较旧，可能存在与2.1版本配置的兼容性问题。卸载旧版本后重新安装最新版，确保CLI版本与平台端配置兼容。

• 排查WSL2文件系统权限（若使用WSL后端）
  若Docker Desktop采用WSL2后端，建议将项目放在WSL2的原生文件系统中（如/home/your-username/your-project），避免使用Windows挂载目录（如/mnt/c/...）。挂载目录的权限限制可能导致CLI无法正常读取配置或执行操作。

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