Angular独立组件中如何全局导入模块？

我有几个希望在应用中全局使用的模块，不想在每个独立组件里重复声明。目前每个组件都得这么写：

@Component({
  selector: 'app-blank',
  templateUrl: './blank.component.html',
  imports: [RouterOutlet, MaterialModule, CommonModule],
  standalone: true,
  styleUrls: [],
})

我想省去每次声明MaterialModule和CommonModule的步骤，于是尝试把它们从组件的imports列表移除，在app.config.ts里做了如下配置：

export const appConfig: ApplicationConfig = {
  providers: [
    provideRouter(routes),
    provideAnimationsAsync(),
    importProvidersFrom(
      CommonModule, // 这里导入
      MaterialModule,// 还有这里
      TablerIconsModule.pick(TablerIcons),
      FeatherModule.pick(allIcons)
    ),
  ],
};

app.config.ts已经在main.ts中引用：

import { appConfig } from './app/app.config';

bootstrapApplication(AppComponent, appConfig).catch((err) =>
  console.error(err)
);

但运行时编译器报错（把这两个模块放回组件imports里就正常）：

X [ERROR] NG8001: 'mat-sidenav-container' is not a known element:                                                                                       
1. If 'mat-sidenav-container' is an Angular component, then verify that it is included in the '@Component.imports' of this component.
2. If 'mat-sidenav-container' is a Web Component then add 'CUSTOM_ELEMENTS_SCHEMA' to the '@Component.schemas' of this component to suppress this message. [plugin angular-compiler]

    src/app/layouts/blank/blank.component.html:4:0:
      4 │ <mat-sidenav-container
        ╵ ~~~~~~~~~~~~~~~~~~~~~~

  Error occurs in the template of component BlankComponent.

    src/app/layouts/blank/blank.component.ts:8:15:
      8 │   templateUrl: './blank.component.html',
        ╵                ~~~~~~~~~~~~~~~~~~~~~~~~


X [ERROR] NG8002: Can't bind to 'ngClass' since it isn't a known property of 'mat-sidenav-container'.
1. If 'mat-sidenav-container' is an Angular component and it has 'ngClass' input, then verify that it is included in the '@Component.imports' of this component.
2. If 'mat-sidenav-container' is a Web Component then add 'CUSTOM_ELEMENTS_SCHEMA' to the '@Component.schemas' of this component to suppress this message.
3. To allow any property add 'NO_ERRORS_SCHEMA' to the '@Component.schemas' of this component. [plugin angular-compiler]

    src/app/layouts/blank/blank.component.html:5:2:
      5 │   [ngClass]="{
        ╵   ~~~~~~~~~~~~

  Error occurs in the template of component BlankComponent.

    src/app/layouts/blank/blank.component.ts:8:15:
      8 │   templateUrl: './blank.component.html',

这是刚从Angular 16迁移到17的应用，我的angular.json已经改成用vite新构建器：

{
  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
  "version": 1,
  "newProjectRoot": "projects",
  "projects": {
    "flexy": {
      "projectType": "application",
      "schematics": {
        "@schematics/angular:component": {
          "style": "scss"
        }
      },
      "root": "",
      "sourceRoot": "src",
      "prefix": "app",
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:application",
          "options": {
            "allowedCommonJsDependencies": [
              "@swimlane/ngx-charts",
              "ng-apexcharts",
              "ngx-scrollbar",
              "rfdc",
              "apexcharts",
              "bezier-easing",
              "c3"
            ],
            "outputPath": "dist/flexy",
            "browser": "src/main.ts",
            "index": "src/index.html",
            "polyfills": ["zone.js"],
            "tsConfig": "tsconfig.app.json",
            "inlineStyleLanguage": "scss",
            "assets": ["src/favicon.ico", "src/assets"],
            "styles": [
              "src/styles.scss",
              "src/assets/scss/style.scss"
            ],
            "scripts": []
          },
          "configurations": {
            "production": {
              "budgets": [
                {
                  "type": "initial",
                  "maximumWarning": "12mb",
                  "maximumError": "12mb"
                },
                {
                  "type": "anyComponentStyle",
                  "maximumWarning": "12mb",
                  "maximumError": "12mb"
                }
              ],
              "outputHashing": "all"
            },
            "development": {
              "optimization": false,
              "extractLicenses": false,
              "sourceMap": true,
              "namedChunks": true
            }
          },
          "defaultConfiguration": "production"
        },
        "serve": {
          "builder": "@angular-devkit/build-angular:dev-server",
          "configurations": {
            "production": {
              "buildTarget": "flexy:build:production"
            },
            "development": {
              "buildTarget": "flexy:build:development"
            }
          },
          "defaultConfiguration": "development"
        },
        "extract-i18n": {
          "builder": "@angular-devkit/build-angular:extract-i18n",
          "options": {
            "buildTarget": "flexy:build"
          }
        },
        "test": {
          "builder": "@angular-devkit/build-angular:karma",
          "options": {
            "polyfills": ["zone.js", "zone.js/testing"],
            "tsConfig": "tsconfig.spec.json",
            "inlineStyleLanguage": "scss",
            "assets": ["src/favicon.ico", "src/assets"],
            "styles": ["src/styles.scss"],
            "scripts": []
          }
        }
      }
    }
  },
  "cli": {
    "analytics": false
  }
}

补充说明：我要解决的不是单个组件的导入问题（比如RouterOutlet），而是如何让包含多个组件/指令的模块全局生效，不用每个组件都加。

解决方案 #

核心问题：你用错了API——importProvidersFrom只能注册模块中的服务，无法让模块里的组件、指令、管道在所有独立组件的模板中全局可用。

正确的做法是利用Angular 17+ ApplicationConfig新增的imports字段，直接把要全局共享的模块放在这里：

1. 修改app.config.ts，添加imports配置项：

export const appConfig: ApplicationConfig = {
  // 把需要全局共享的模块放到这里
  imports: [
    CommonModule,
    MaterialModule,
    TablerIconsModule.pick(TablerIcons),
    FeatherModule.pick(allIcons)
  ],
  providers: [
    provideRouter(routes),
    provideAnimationsAsync(),
    // 这里不需要再用importProvidersFrom导入上述模块，除非模块内有必须单独注册的服务
  ],
};

2. 验证效果：

   • 所有独立组件的模板可以直接使用mat-sidenav-container、ngClass等来自全局导入模块的内容，无需在组件的@Component.imports里重复声明。
   • 如果你的MaterialModule是传统NgModule，Angular 17也能兼容，但建议改成独立模块（添加standalone: true）以获得更好的树摇效果。

3. 额外注意：

   • 模块中的服务如果已经用providedIn: 'root'注册，不需要额外处理；如果是模块级别的providers，Angular会自动通过appConfig.imports中的模块注册这些服务。
   • 全局导入的模块会影响所有组件，注意不要导入不需要的模块，避免打包体积过大。

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