Angular 17升级至19后Moment.js与sockjs-client导入报错求助

针对你升级Angular到19版本后，修改默认导入语法出现的Module can only be default-imported using the allowSyntheticDefaultImports flag错误，以下是可行的解决方向：

1. 排查TS配置的继承与覆盖问题 #

Angular项目通常存在多个tsconfig文件（如tsconfig.app.json、tsconfig.spec.json），主tsconfig.json的配置可能被子文件覆盖：

• 检查子配置文件是否通过extends字段正确继承主tsconfig.json；
• 确保所有子配置的compilerOptions中，allowSyntheticDefaultImports和esModuleInterop未被手动设为false。

示例正确的子配置继承方式：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    // 避免单独设置与主配置冲突的选项
  }
}

2. 更新类型定义包 #

旧版本的类型定义可能不兼容默认导入语法，执行以下命令更新类型包：

npm install @types/moment @types/sockjs-client --save-dev

确保类型包版本与对应库、Angular 19适配的TypeScript版本（5.3+）兼容。

3. 调整模块解析策略 #

在tsconfig.json的compilerOptions中明确设置模块解析方式，适配Angular 19的打包工具：

{
  "compilerOptions": {
    "moduleResolution": "bundler",
    "module": "ES2022",
    "target": "ES2022"
  }
}

bundler是Angular 18+推荐的解析策略，可更好兼容Vite/Esbuild打包逻辑。

4. 临时兼容方案 #

若以上方法无效，可暂时调整导入方式规避错误：

• 改回命名导入，直接使用：

  import * as moment from 'moment';
  const now = moment();
  

• 或给默认导入添加类型断言：

  import moment from 'moment';
  const momentInstance = moment as typeof import('moment');
  

5. 校验版本兼容性 #

确认package.json中依赖版本匹配Angular 19要求：

• 检查typescript版本是否为5.3.x（Angular 19指定兼容版本）；
• 确保@angular/cli、@angular/core与Angular 19版本一致，无跨版本依赖冲突。

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