NX monorepo无法解析zone.js等依赖及样式文件问题求助

1. 包管理器不一致导致的PnP冲突 #

同事环境可能使用Yarn，而你用NPM，导致Yarn Plug'n'Play(PnP)清单干扰依赖解析：

• 检查项目根目录，若存在yarn.lock，切换为Yarn重新安装依赖：

  npm uninstall -g nx
  yarn global add nx
  yarn install
  

• 若仅存在package-lock.json，清理Yarn相关文件后用NPM重装：

  rm -rf yarn.lock .pnp.cjs .pnp.loader.mjs node_modules
  npm install
  

2. NX本地缓存与状态污染 #

清理NX缓存和残留构建状态，再重装依赖：

nx reset
rm -rf node_modules package-lock.json yarn.lock .pnp.*
# 对应包管理器执行安装
npm install # 或 yarn install

3. SCSS导入路径配置问题 #

• 检查angular.json中my-app配置的stylePreprocessorOptions，确认includePaths包含库样式目录：

  "stylePreprocessorOptions": {
    "includePaths": [
      "libs/my-lib/src/styles"
    ]
  }
  

• 核对SCSS文件中的相对导入路径，避免大小写错误或层级偏差。

4. NX全局与本地版本冲突 #

确保全局NX版本和项目本地版本一致：

nx --version # 查看全局版本
npx nx --version # 查看项目本地版本

若版本不一致，卸载全局NX并使用项目本地命令：

npm uninstall -g nx
npx nx serve my-app

5. Yarn PnP残留配置清理 #

删除Yarn专属配置文件，消除PnP模式影响：

rm -rf .yarnrc.yml .pnp.cjs .pnp.loader.mjs

之后重新执行依赖安装。

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