Angular 18中tslib模块找不到错误及解决方案咨询

错误原因 #

Angular 18默认使用bundler作为moduleResolution策略，这个策略的核心是让打包工具（比如Angular CLI内置的esbuild）负责模块解析逻辑。但VS Code的TypeScript语言服务（独立于打包工具运行）在做语法检查时，无法识别打包工具对tslib的解析规则——tslib是TypeScript编译时依赖的辅助库，Angular项目会自动引入它来处理装饰器、扩展运算符等语法的辅助代码。当TypeScript服务找不到tslib的正确路径时，就会抛出这个2354错误。

替代解决方案（无需修改moduleResolution） #

• 确认tslib已正确安装：
  执行命令手动安装或重新安装依赖，确保tslib存在于项目的node_modules中：

  npm install tslib --save
  

  如果用pnpm或yarn，对应替换为pnpm add tslib或yarn add tslib。

• 显式配置tslib路径：
  在tsconfig.json的compilerOptions中添加paths配置，直接告诉TypeScripttslib的位置：

  {
    "compilerOptions": {
      // 其他配置...
      "paths": {
        "tslib": ["./node_modules/tslib/tslib.d.ts"]
      }
    }
  }
  

• 使用项目本地的TypeScript版本：
  VS Code默认自带TypeScript版本，可能与Angular 18依赖的TS版本不兼容。点击VS Code右下角的TypeScript版本号，选择Use Workspace Version，让编辑器使用项目node_modules中的TS版本，确保解析逻辑与项目一致。

为什么修改moduleResolution为node能解决问题 #

node是传统的Node.js模块解析策略，TypeScript会直接按照Node.js的规则从node_modules目录查找依赖，因此能顺利找到tslib。但这个改动会绕过Angular 18默认的bundler优化策略，长期来看可能影响打包效率或兼容性，因此更推荐上面的替代方案。

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