使用GitHub Actions CI构建Angular项目时NX报错：找不到@nx/nx-linux-x64-gnu模块

错误详情 #

构建时触发npm错误：

npm ERR! code 1
npm ERR! path /runner/_work/myapp/node_modules/nx
npm ERR! command failed npm ERR! command sh -c node ./bin/post-install
npm ERR! /runner/_womyapp/node_modules/nx/src/native/index.js:244
npm ERR!     throw loadError
npm ERR!     ^
npm ERR!
npm ERR! Error: Cannot find module '@nx/nx-linux-x64-gnu'

NX官方提示：

NX 缺失平台依赖
Nx CLI无法找到或加载您的支持平台（linux-x64）对应的原生二进制文件。这可能意味着可选依赖未正确安装，或者您的系统缺少某些系统依赖。

修复方案 #

1. 强制重新安装依赖 #

在GitHub Actions步骤中执行强制安装，确保可选平台包被完整拉取：

npm ci --force
# 若使用Yarn：
# yarn install --force

也可单独重装NX：

npm uninstall nx
npm install nx --save-dev

2. 禁用NX原生CLI #

如果无需原生CLI的性能优势，可通过环境变量强制使用JS版本，跳过原生依赖加载：
在workflow文件中添加环境变量：

env:
  NX_NATIVE_CLI: 'false'

或在构建命令前临时设置：

NX_NATIVE_CLI=false npm run build

3. 补充系统依赖 #

Ubuntu runner可能缺少NX原生包所需的系统库，添加安装步骤：

- name: Install required system libs
  run: sudo apt-get update && sudo apt-get install -y libatomic1

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