Angular 19类库迁移报错：'imports'仅在独立组件上有效

老哥，我刚巧也踩过这个Angular 19迁移的坑！自动迁移工具有时候确实会抽风，给你几个我亲测有效的解决办法，你挨个试试：

1. 先把standalone: true显式加回去 #

虽然Angular 19官方说所有组件默认是独立的，但类库场景下可能存在编译逻辑的特殊处理，显式声明反而能让编译器和语言服务立刻识别到组件的独立属性。修改后的组件装饰器应该是这样：

@Component({
    selector: "custom-component",
    templateUrl: "./custom.component.html",
    styleUrls: ["./custom.component.scss"],
    standalone: true, // 显式加上这行
    imports: [
        MatIconModule,
        CommonModule,
        // 你的其他依赖模块
    ],
})

我当时就是加了这行，报错立刻就消失了。

2. 检查类库的编译配置 #

打开项目根目录的tsconfig.lib.json，确认angularCompilerOptions里的配置是否正确（类库项目一定要确保Ivy启用）：

{
  "compilerOptions": {
    // 你的其他编译选项
  },
  "angularCompilerOptions": {
    "standaloneComponents": true,
    "enableIvy": true
  }
}

3. 彻底清理缓存+重装依赖 #

有时候缓存是万恶之源，按这个顺序操作准没错：

• 先关掉所有VS Code窗口
• 删除项目根目录的node_modules文件夹、package-lock.json（用yarn的话就删yarn.lock）
• 执行npm install（或yarn install）重新安装所有依赖
• 执行ng cache clean --all清理Angular的全局缓存
• 重新打开VS Code，再看组件的报错情况

4. 确认组件没有在NgModule里重复声明 #

如果你的类库还保留了NgModule，一定要检查：这个组件绝对不能同时出现在NgModule的declarations数组里！独立组件和NgModule声明是互斥的，一旦同时存在就会触发类似的报错。

如果以上方法都没用，你再检查下全局Angular CLI版本和项目本地CLI版本是否完全一致——版本不匹配经常会导致各种莫名其妙的编译问题。

备注：内容来源于stack exchange，提问作者Prashant sharma