填寫這份《一分鐘調查》,幫我們(開發組)做得更好!去填寫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 build <project> [options]
    
ng b <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.

引數

引數說明
<project>

要建構的專案名。可以是應用或函式庫。

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

選項

選項說明
--allowed-common-js-dependencies

允許在沒有建構期警告的前提下使用的 CommonJS 軟體套件列表。

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

--aot=true|false

使用預先編譯模式進行建構。

Build using Ahead of Time compilation.

預設值: false

--base-href=base-href

正在建構的應用程式的 base URL。

Base url for the application being built.

--build-optimizer=true|false

當使用 'aot' 選項時啟用 '@angular-devkit/build-optimizer' 優化。

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

預設值: false

--common-chunk=true|false

產生一個單獨的捆綁套件,其中包含跨多個捆綁套件使用的程式碼。

Generate a seperate bundle containing code used across multiple bundles.

預設值: true

--configuration=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

--cross-origin=
none|anonymous|use-credentials

定義提供 CORS 支援的元素的 crossorigin 屬性設定。

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

預設值: none

--delete-output-path=true|false

在建構之前,刪除輸出路徑。

Delete the output path before building.

預設值: true

--deploy-url=deploy-url

檔案將部署到的 URL。

URL where files will be deployed.

--experimental-rollup-pass=true|false

在用 Webpack 對一些模組進行打包之前,先用 Rollup 把它們連成一個檔案。

Concatenate modules with Rollup before bundling them with Webpack.

預設值: false

--extract-css=true|false

已棄用:

從 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'.

預設值: true

--extract-licenses=true|false

將所有許可證(license)提取到一個單獨的檔案中。

Extract all licenses in a separate file.

預設值: false

--fork-type-checker=true|false

在子程序(forked process)中執行 TypeScript 型別檢查器。

Run the TypeScript type checker in a forked process.

預設值: true

--help=
true|false|json|JSON

在控制檯顯示關於本命令的幫助資訊。

Shows a help message for this command in the console.

預設值: false

--i18n-file=i18n-file

已棄用:

改用專案元資料中的 'locales' 物件代替。

Use 'locales' object in the project metadata instead.

用於 i18n 的本地化檔案。

Localization file to use for i18n.

--i18n-format=i18n-format

已棄用:

不需要了,因為現在會自動確定格式。

No longer needed as the format will be determined automatically.

用 --i18n-file 指定的本地化檔案的格式。

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

--i18n-locale=i18n-locale

已棄用:

使用 'localize' 代替。

Use 'localize' instead.

用於 i18n 的語言環境。

Locale to use for i18n.

--i18n-missing-translation=
warning|error|ignore

i18n 要如何處理缺失翻譯。

How to handle missing translations for i18n.

預設值: warning

--index=index

配置應用程式的 index.html 的產生方式。

Configures the generation of the application's HTML index.

--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.

--localize=true|false

在一個或多個語言環境下翻譯這些套件。

Translate the bundles in one or more locales.

--main=main

應用程式主入口點的完整路徑。是相對於當前工作空間的。

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

--named-chunks=true|false

對於延遲載入的塊,使用檔名進行命名。

Use file name for lazy loaded chunks.

預設值: true

--ngsw-config-path=
ngsw-config-path

ngsw-config.json 的路徑。

Path to ngsw-config.json.

--optimization=true|false

啟用建構輸出的優化。包括指令碼和樣式的最小化、搖樹優化、消除死程式碼、內聯關鍵 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.

預設值: false

--output-hashing=
none|all|media|bundles

定義輸出檔名的快取無效雜湊(cache-busting hashing)的模式。

Define the output filename cache-busting hashing mode.

預設值: none

--output-path=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.

--poll

啟用並定義檔案監視的輪詢間隔(以毫秒為單位)。

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

--polyfills=polyfills

polyfills 檔案的完整路徑。是相對於當前工作空間的。

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

--preserve-symlinks=true|false

當解析模組時,不要使用真實路徑。如果未設定,則如果 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.

--prod=true|false

"--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.

--progress=true|false

在建構時將進度記錄到控制檯。

Log progress to the console while building.

預設值: true

--resources-output-path=
resources-output-path

放置樣式資源的路徑,是相對於 outputPath 的。

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

預設值:

--service-worker=true|false

在生產環境建構中產生 Service Worker 配置。

Generates a service worker config for production builds.

預設值: false

--show-circular-dependencies=true|false

在建構中顯示迴圈依賴項警告。

Show circular dependency warnings on builds.

預設值: true

--source-map=true|false

輸出指令碼和樣式的原始碼對映資訊。欲知詳情,請參閱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.

預設值: true

--stats-json=true|false

產生一個 “stats.json” 檔案,可以使用 “webpack-bundle-analyzer” 之類別的工具進行分析。

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

預設值: false

--subresource-integrity=true|false

啟用子資源完整性驗證。

Enables the use of subresource integrity validation.

預設值: false

--ts-config=ts-config

TypeScript 配置檔案相對於當前工作空間的完整路徑。

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

--vendor-chunk=true|false

產生僅包含供應商函式庫的單獨捆綁套件。此選項只能用於開發階段。

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

預設值: true

--verbose=true|false

將更多詳細資訊新增到輸出日誌記錄。

Adds more details to output logging.

預設值: false

--watch=true|false

當檔案更改時自動建構。

Run build when files change.

預設值: false

--web-worker-ts-config=
web-worker-ts-config

Web Worker 模組的 TypeScript 配置。

TypeScript configuration for Web Worker modules.