Angular v8项目编译误引用全局TypeScript版本问题求助

• 编译抛出Assert identifier is declared twice错误，核心原因是编译流程错误加载了全局安装的TypeScript v4.7：TS4.7新增了内置assert关键字的类型声明，和Angular v8适配的TS3.4生态下的类型定义冲突，且Angular v8本身仅兼容TS3.2~3.5版本，加载高版本全局TS必然触发编译异常。
• 正常情况下Yarn执行脚本时会优先加载本地node_modules内的依赖，但IDE类型检查配置错误、直接调用全局TS/ng指令、环境变量路径优先级异常时，就会跳过本地版本加载全局TS。

1. 强制命令行编译使用本地TS #

所有项目编译、启动命令统一通过yarn run执行，Yarn会自动将本地node_modules/.bin目录放到环境变量最前，优先加载本地安装的TS、Angular CLI版本，不会检索全局依赖。
版本校验：在项目根目录执行yarn tsc -v，返回版本为3.4.5即代表命令行层面已正确拾取本地TS。
禁止直接使用全局安装的tsc/ng指令执行项目相关操作，这类指令会默认加载全局路径下的TS版本。

2. 修正IDE的TS版本配置 #

多数场景下的报错是IDE内置的TS服务使用了全局版本：

• VS Code：按快捷键Ctrl+Shift+P（Mac端为Cmd+Shift+P），调出命令面板后输入TypeScript: Select TypeScript Version，选择Use Workspace Version，即项目node_modules内安装的3.4.5版本即可。
• WebStorm：打开Settings > Languages & Frameworks > TypeScript，将TypeScript路径手动指定为项目下node_modules/typescript/lib目录，不要选择全局安装的TS路径。

3. 调整tsconfig阻止全局类型加载 #

现有tsconfig的typeRoots已配置为仅检索本地node_modules的@types目录，额外添加types配置即可阻止TS自动加载全局路径下的类型文件，修改后compilerOptions内对应配置段如下：

{
  "compilerOptions": {
    // 原有其他配置保持不变
    "skipLibCheck": true,
    "moduleResolution": "node",
    "typeRoots": [
      "../node_modules/@types"
    ],
    "types": [], // 新增该行，禁用全局类型自动加载
    "baseUrl": ".",
    // 原有paths等其余配置保持不变
  }
}

4. 清理缓存排除旧产物干扰 #

依次执行以下命令清理依赖缓存和Angular编译缓存：

# 删除旧依赖和锁文件重新安装
rm -rf node_modules yarn.lock
yarn install
# 清理Angular编译缓存
yarn ng cache clean

重新执行项目启动/构建命令，不再出现assert重复声明报错，且编译日志中加载的TypeScript版本为3.4.5即配置生效。

注意：不要尝试将本地TS升级到4.7版本适配全局安装包，Angular v8的编译器完全不兼容TS4.x系列版本，升级后会触发大量不可预期的编译错误。

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