执行npm start启动项目报@angular/compiler无R3SelectorScopeMode导出错误

该异常是Angular生态依赖版本不匹配导致的：R3SelectorScopeMode是@angular/compiler包特定版本内置的导出项，当@angular/compiler与@angular/core、@angular/cli、@angular/platform-browser-dynamic等Angular核心包版本不一致，或是安装json-server、json-server-auth过程中触发依赖树提升冲突、锁文件损坏时，就会出现该导出项缺失的报错。

• 方案1：对齐所有Angular核心包版本
  先清理损坏的依赖和锁文件，再统一版本重装：

  # 移除现有依赖目录和锁文件
  rm -rf node_modules package-lock.json
  # 先查询当前项目原本使用的Angular主版本（例如15、16、17），记录后执行版本对齐安装
  ng version
  # 替换命令里的<主版本号>为你查到的实际版本
  npm install @angular/cli@<主版本号> -g
  npm install @angular/core@<主版本号> @angular/compiler@<主版本号> @angular/common@<主版本号> @angular/platform-browser@<主版本号> @angular/platform-browser-dynamic@<主版本号> --save
  # 重新安装全量依赖
  npm install
  

  安装完成后重新执行npm start验证即可。
• 方案2：解决json-server相关依赖冲突
  如果报错是在集成json-server、json-server-auth之后首次出现，说明这两个包的依赖传递导致了@angular/compiler版本被意外篡改，可在package.json中做两项调整：
  1. 将json-server、json-server-auth移到devDependencies节点下，避免生产依赖树冲突
  2. 添加overrides配置强制所有子依赖使用项目本身指定的@angular/compiler版本：

     "overrides": {
       "@angular/compiler": "$@angular/compiler"
     }
     

  修改完成后，重复方案1中清理依赖、锁文件后重装的步骤即可。
• 方案3：校验自定义构建工具版本
  如果项目使用@angular-builders/custom-webpack等自定义构建工具，需保证该包的主版本号与项目Angular主版本号完全一致（例如Angular 16对应@angular-builders/custom-webpack@16），版本错位也会触发编译器导出异常。

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