Angular项目执行ng build报错：MatTooltipModule需添加@NgModule注解

这个错误我之前也碰到过，本质是Angular无法识别你导入的MatTooltipModule为合法的NgModule，通常是导入路径不对或者版本不兼容导致的，给你几个靠谱的解决步骤：

• 修正导入路径
  大部分情况下，问题出在导入路径上。在Angular Material的标准版本中，MatTooltipModule应该从根包路径导入，而非子路径@angular/material/tooltip。把你的导入语句改成：

  import { MatTooltipModule } from '@angular/material';
  

  如果你使用的是Angular Material 15+的独立组件模式，也可以保留子路径导入，但要确保导入的是模块而非单独组件，此时路径写法是正确的，但需要配合对应版本的Angular核心库使用。

• 检查版本兼容性
  打开项目根目录的package.json，确认@angular/core和@angular/material的主版本号完全一致（比如都是14.2.x，或者都是15.1.x）。如果版本不匹配，Angular会无法正确解析Material模块的结构，进而触发这个错误。如果版本不一致，你可以升级或降级其中一方，确保版本对齐后重新执行npm install。

• 确认模块已添加到AppModule的imports数组
  务必确保你已经在AppModule的imports数组中声明了MatTooltipModule，示例代码如下：

  @NgModule({
    declarations: [AppComponent],
    imports: [
      BrowserModule,
      // ...其他必要模块
      MatTooltipModule // 确保这里存在该模块声明
    ],
    providers: [],
    bootstrap: [AppComponent]
  })
  export class AppModule { }
  

• 清理缓存和依赖
  如果上面的步骤都没解决问题，可以尝试清理缓存重置依赖：

  1. 删除项目根目录下的node_modules文件夹和package-lock.json（或yarn.lock）文件
  2. 运行npm install重新安装所有依赖
  3. 执行ng build --clean清理Angular的构建缓存后再重新构建

简单来说，这个错误的核心是你导入的不是一个合法的NgModule——要么是路径错误导到了类型定义文件，要么是版本不兼容导致模块结构异常，按上面的步骤排查基本就能解决问题。

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