使用Azure构建依赖@emotion/react的Material-UI v5应用时出错如何解决

• 核对本地与Azure Pipeline的Node.js、包管理器（npm/yarn/pnpm）版本是否完全一致，不同版本的包管理器依赖提升、隔离逻辑差异较大，是触发该类依赖报错的常见原因。
• 确认项目的依赖锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）已提交到代码仓库，CI未使用锁文件安装依赖时会拉取最新兼容版本，导致依赖树和本地不一致触发报错。
• 检查CI的依赖安装命令是否和本地一致，若CI命令携带--no-package-lock、--force等参数，会改变依赖安装结果，触发版本冲突。
• 核对@mui/material、@emotion/react、@emotion/styled等核心依赖版本是否匹配，本地可能因旧缓存未触发冲突，CI清空缓存安装后会暴露版本不兼容问题。

• 统一本地与CI的运行环境，在Azure Pipeline中通过NodeTool@0任务指定和本地完全一致的Node.js、包管理器版本，避免环境差异。
• 若使用pnpm作为包管理器，可在项目根目录的.npmrc文件中添加以下配置，解决依赖隔离导致的找不到包问题：

public-hoist-pattern[]=*@emotion/*
public-hoist-pattern[]=*@mui/*
auto-install-peers=true

• 直接安装提示缺失的依赖，执行对应包管理器的安装命令即可：
  npm install isolated-hoist-non-react-statistics
• 清理CI的依赖缓存，配置Pipeline每次构建前清空旧的依赖缓存，确保依赖安装完全基于锁文件的内容，避免旧缓存带来的依赖冲突。
• 检查package.json的peerDependencies配置，补全遗漏的emotion、MUI相关 peer 依赖声明后重新运行CI。

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