填写这份《一分钟调查》,帮我们(开发组)做得更好!去填写Home

ng build

把 Angular 应用编译到给定输出路径下名为 dist/ 的输出目录中。此命令必须在工作空间目录下执行。

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 b <project> [options]
    

说明

该命令可用于构建“应用程序”或“库”类型的项目。当用于构建库时,将调用其他构建器,并且仅应用 ts-configconfigurationwatch 选项。所有其他选项仅适用于构建应用程序。

The command can be used to build a project of type "application" or "library". When used to build a library, a different builder is invoked, and only the ts-config, configuration, and watch options are applied. All other options apply only to building applications.

应用程序构建器使用 webpack 作为构建工具,并在工作区配置文件(angular.json)中指定默认配置选项,或者使用有名字的替代配置。使用 CLI 创建项目时,默认情况下会创建 "production" 配置,并且可以通过指定 --configuration="production"--prod 选项来使用该配置。

The application builder 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 --configuration="production" or the --prod option.

配置选项通常与命令选项相对应。你可以通过在命令行上指定相应的选项来覆盖各个配置的默认值。该命令可以接受以中线形式(dash-case)或小驼峰形式(camelCase)给出的选项名称。请注意,在配置文件中,必须以小驼峰形式指定名称。

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.

某些其他选项只能通过配置文件设置,方法是直接编辑它或使用 ng config 命令。其中包括 assetsstylesscripts 对象,这些对象提供了一些要包括在项目中的运行时全局资源。 CSS 中的资源(例如图像和字体)会自动写入输出文件夹的根目录并添加文件指纹。

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.

参数

参数说明Value Type
<project>

要构建的项目名。可以是应用或库。

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

string

选项

选项说明Value TypeDefault Value
--allowed-common-js-dependencies

允许在没有构建期警告的前提下使用的 CommonJS 软件包列表。

A list of CommonJS packages that are allowed to be used without a build time warning.

array
--aot

使用预先编译模式进行构建。

Build using Ahead of Time compilation.

booleanfalse
--base-href

正在构建的应用程序的 base URL。

Base url for the application being built.

string
--build-optimizer

当使用 'aot' 选项时启用 '@angular-devkit/build-optimizer' 优化。

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

booleanfalse
--common-chunk

生成一个单独的捆绑包,其中包含跨多个捆绑包使用的代码。

Generate a seperate bundle containing code used across multiple bundles.

booleantrue
--configuration

构建器的一个或多个命名配置,是一个逗号分隔的列表,就像在 angular.json 的 "configurations" 部分指定的一样。 构建器使用这些命名配置运行给定的目标。 欲知详情,参见 https://angular.cn/guide/workspace-config#alternate-build-configurations。 可以通过显式指定 "--prod" 标志来覆盖它。

One or more named builder configurations as a comma-separated list as specified in the "configurations" section of angular.json. The builder uses the named configurations to run the given target. For more information, see https://angular.io/guide/workspace-config#alternate-build-configurations. Setting this explicitly overrides the "--prod" flag.

别名: -c

string
--cross-origin

定义提供 CORS 支持的元素的 crossorigin 属性设置。

Define the crossorigin attribute setting of elements that provide CORS support.

none|anonymous|use-credentialsnone
--delete-output-path

在构建之前,删除输出路径。

Delete the output path before building.

booleantrue
--deploy-url

文件将部署到的 URL。

URL where files will be deployed.

string
--experimental-rollup-pass

在用 Webpack 对一些模块进行打包之前,先用 Rollup 把它们连成一个文件。

Concatenate modules with Rollup before bundling them with Webpack.

booleanfalse
--extract-css

已弃用:

从 11.0 开始已弃用。因为 HMR 要禁用 CSS 提取,所以不需要了。

Deprecated since version 11.0. No longer required to disable CSS extraction for HMR.

从全局样式中将 CSS 提取到 “.css”文件而不是 “.js”文件中。

Extract CSS from global styles into '.css' files instead of '.js'.

booleantrue
--extract-licenses

将所有许可证(license)提取到一个单独的文件中。

Extract all licenses in a separate file.

booleanfalse
--fork-type-checker

在子进程(forked process)中运行 TypeScript 类型检查器。

Run the TypeScript type checker in a forked process.

booleantrue
--help

在控制台显示关于本命令的帮助信息。

Shows a help message for this command in the console.

true|false|json|JSONfalse
--i18n-file

已弃用:

改用项目元数据中的 'locales' 对象代替。

Use 'locales' object in the project metadata instead.

用于 i18n 的本地化文件。

Localization file to use for i18n.

string
--i18n-format

已弃用:

不需要了,因为现在会自动确定格式。

No longer needed as the format will be determined automatically.

用 --i18n-file 指定的本地化文件的格式。

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

string
--i18n-locale

已弃用:

使用 'localize' 代替。

Use 'localize' instead.

用于 i18n 的语言环境。

Locale to use for i18n.

string
--i18n-missing-translation

i18n 要如何处理缺失翻译。

How to handle missing translations for i18n.

warning|error|ignorewarning
--index

配置应用程序的 index.html 的生成方式。

Configures the generation of the application's HTML index.

string
--lazy-modules

已弃用:

'SystemJsNgModuleLoader' 已弃用,这是它的一部分。用 'import()' 语法代替。

'SystemJsNgModuleLoader' is deprecated, and this is part of its usage. Use 'import()' syntax instead.

要惰性加载的其他 NgModule 文件的列表。那些惰性加载的路由模块会自动发现,不用在这里添加。

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

array
--localize

在一个或多个语言环境下翻译这些包。

Translate the bundles in one or more locales.

boolean
--main

应用程序主入口点的完整路径。是相对于当前工作空间的。

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

string
--named-chunks

对于惰性加载的块,使用文件名进行命名。

Use file name for lazy loaded chunks.

booleantrue
--ngsw-config-path

ngsw-config.json 的路径。

Path to ngsw-config.json.

string
--optimization

启用构建输出的优化。包括脚本和样式的最小化、摇树优化、消除死代码、内联关键 CSS 和内联字体等。欲知详情,请参阅https://angular.cn/guide/workspace-config#optimization-configuration

Enables optimization of the build output. Including minification of scripts and styles, tree-shaking, dead-code elimination, inlining of critical CSS and fonts inlining. For more information, see https://angular.io/guide/workspace-config#optimization-configuration.

booleanfalse
--output-hashing

定义输出文件名的缓存无效哈希(cache-busting hashing)的模式。

Define the output filename cache-busting hashing mode.

none|all|media|bundlesnone
--output-path

新输出目录的完整路径,是相对于当前工作空间的。

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

默认情况下,会将输出写入当前项目中名为 dist/ 的文件夹。

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

string
--poll

启用并定义文件监视的轮询间隔(以毫秒为单位)。

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

number
--polyfills

polyfills 文件的完整路径。是相对于当前工作空间的。

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

string
--preserve-symlinks

当解析模块时,不要使用真实路径。如果未设置,则如果 NodeJS 启用了 --preserve-symlinks 选项,就默认为 true

Do not use the real path when resolving modules. If unset then will default to true if NodeJS option --preserve-symlinks is set.

boolean
--prod

"--configuration=production" 的简写形式。 把构建配置的目标设置为产品环境。 默认情况下,产品环境目标是在工作空间配置中设置的,可以设置打包方式、摇树优化限制、死代码移除限制等方面。

Shorthand for "--configuration=production". Set the build configuration to the production target. By default, the production target is set up in the workspace configuration such that all builds make use of bundling, limited tree-shaking, and also limited dead code elimination.

boolean
--progress

在构建时将进度记录到控制台。

Log progress to the console while building.

booleantrue
--resources-output-path

放置样式资源的路径,是相对于 outputPath 的。

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

string
--service-worker

在生产环境构建中生成 Service Worker 配置。

Generates a service worker config for production builds.

booleanfalse
--show-circular-dependencies

在构建中显示循环依赖项警告。

Show circular dependency warnings on builds.

booleantrue
--source-map

输出脚本和样式的源码映射信息。欲知详情,请参阅https://angular.cn/guide/workspace-config#source-map-configuration

Output source maps for scripts and styles. For more information, see https://angular.io/guide/workspace-config#source-map-configuration.

booleantrue
--stats-json

生成一个 “stats.json” 文件,可以使用 “webpack-bundle-analyzer” 之类的工具进行分析。

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

booleanfalse
--subresource-integrity

启用子资源完整性验证。

Enables the use of subresource integrity validation.

booleanfalse
--ts-config

TypeScript 配置文件相对于当前工作空间的完整路径。

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

string
--vendor-chunk

生成仅包含供应商库的单独捆绑包。此选项只能用于开发阶段。

Generate a seperate bundle containing only vendor libraries. This option should only used for development.

booleantrue
--verbose

将更多详细信息添加到输出日志记录。

Adds more details to output logging.

booleanfalse
--watch

当文件更改时自动构建。

Run build when files change.

booleanfalse
--web-worker-ts-config

Web Worker 模块的 TypeScript 配置。

TypeScript configuration for Web Worker modules.

string