ng build

Compiles an Angular app into an output directory named dist/ at the given output path. Must be executed from within a workspace directory.

ng build <project> [options]
      ng build <project> [options]
ng b <project> [options]
      ng b <project> [options]


Uses the webpack build tool, with default configuration options specified in the workspace configuration file (angular.json) or with a named alternative configuration. A "production" configuration is created by default when you use the CLI to create the project, and you can use that configuration by specifying the --prod option.

The configuration options generally correspond to the command options. You can override individual configuration defaults by specifying the corresponding options on the command line. The command can accept option names given in either dash-case or camelCase. Note that in the configuration file, you must specify names in camelCase.

Some additional options can only be set through the configuration file, either by direct editing or with the ng config command. These include assets, styles, and scripts objects that provide runtime-global resources to include in the project. Resources in CSS, such as images and fonts, are automatically written and fingerprinted at the root of the output folder.

For further details, see Workspace Configuration.



The name of the project to build. Can be an app or a library.



Build using Ahead of Time compilation.

默认值: false


Base url for the application being built.


(experimental) Output file path for Build Event Protocol events


Enables '@angular-devkit/build-optimizer' optimizations when using the 'aot' option.

默认值: false


Use a separate bundle containing code used across multiple bundles.

默认值: true


A named build target, as specified in the "configurations" section of angular.json. Each named target is accompanied by a configuration of option defaults for that target.

别名: -c


Delete the output path before building.

默认值: true


URL where files will be deployed.


Output in-file eval sourcemaps.

默认值: false


Extract css from global styles into css files instead of js ones.

默认值: false


Extract all licenses in a separate file.

默认值: false


Run the TypeScript type checker in a forked process.

默认值: true


Shows a help message for this command in the console.

默认值: false


Localization file to use for i18n.


Format of the localization file specified with --i18n-file.


Locale to use for i18n.


How to handle missing translations for i18n.


The name of the index HTML file.


List of additional NgModule files that will be lazy loaded. Lazy router modules will be discovered automatically.


The full path for the main entry point to the app, relative to the current workspace.


Use file name for lazy loaded chunks.

默认值: true


Path to ngsw-config.json.


Enables optimization of the build output.

默认值: false


Define the output filename cache-busting hashing mode.

默认值: none


The full path for the new output directory, relative to the current workspace.

By default, writes output to a folder named dist/ in the current project.


Enable and define the file watching poll time period in milliseconds.


The full path for the polyfills file, relative to the current workspace.


Do not use the real path when resolving modules.

默认值: false


When true, sets the build configuration to the production target. All builds make use of bundling and limited tree-shaking. A production build also runs limited dead code elimination.

默认值: false


Output profile events for Chrome profiler.

默认值: false


Log progress to the console while building.

默认值: false


The path where style resources will be placed, relative to outputPath.



Generates a service worker config for production builds.

默认值: false


Show circular dependency warnings on builds.

默认值: true


Flag to prevent building an app shell.

默认值: false


Output sourcemaps.

默认值: true


Generates a 'stats.json' file which can be analyzed using tools such as: 'webpack-bundle-analyzer' or

默认值: false


Enables the use of subresource integrity validation.

默认值: false


The full path for the TypeScript configuration file, relative to the current workspace.


Use a separate bundle containing only vendor libraries.

默认值: true


Resolve vendor packages sourcemaps.

默认值: false


Adds more details to output logging.

默认值: false


Run build when files change.

默认值: false