进行翻译时的 Angular CLI 版本:7.2.1

可用命令及简短描述(已根据常用顺序进行排序)

命令 简写 原文 中文描述
new (n) Creates a new workspace and an initial Angular app. 创建一个新工作区和一个初始 Angular 应用程序。
add Adds support for an external library to your project. 为项目添加对外部库的支持。
generate (g) Generates and/or modifies files based on a schematic. 基于 schematic 生成或者修改文件。
serve (s) Builds and serves your app, rebuilding on file changes. 构建并伺服(运行)应用程序,文件更改时自动重新构建。
build (b) Compiles an Angular app into an output directory named dist/ at the given output path. Must be executed from within a workspace directory. 将 Angular 应用程序编译到 dist/ 目录中。 必须从工作空间目录中执行。
update Updates your application and its dependencies. See https://update.angular.io/ 更新应用程序及其依赖项。见 https://update.angular.io/
config Retrieves or sets Angular configuration values in the angular.json file for the workspace. 在工作空间的 angular.json 文件中检索或设置 Angular 配置值。
doc (d) Opens the official Angular documentation (angular.io) in a browser, and searches for a given keyword. 在浏览器中打开官方 Angular 文档(angular.io),并搜索给定的关键字。
e2e (e) Builds and serves an Angular app, then runs end-to-end tests using Protractor. 构建并伺服(运行) Angular 应用程序,然后使用 Protractor 运行端到端测试。
help Lists available commands and their short descriptions. 列出可用命令及简短描述。
lint (l) Runs linting tools on Angular app code in a given project folder. 在给定项目文件夹中的 Angular 应用程序代码上运行 linting 工具。
run Runs an Architect target with an optional custom builder configuration defined in your project. 使用项目中的自定义构建器运行 Architect 目标。
test (t) Runs unit tests in a project. 在项目中运行单元测试。
version (v) Outputs Angular CLI version. 输出 Angular CLI 版本。
xi18n Extracts i18n messages from source code. 从源代码中提取 i18n 消息。

new 命令详细说明

用法:ng new <name> [可选参数]

可选参数 简写 原文 中文描述
--collection (-c) A collection of schematics to use in generating the initial app. 用于生成初始应用程序的 schematics 集合。
--commit Initial git repository commit information. 初始 git 存储库 commit 信息。
--create-application When true (the default), creates a new initial app project in the new workspace. 如果为 true(默认值),则在新工作空间中创建新的初始应用程序项目。
--defaults When true, disables interactive input prompts for options with a default. 如果为 true,则禁用具有默认选项的交互式输入提示。
--directory The directory name to create the workspace in. 用于创建工作空间的目录名称。
--dry-run (-d) When true, runs through and reports activity without writing out results. 如果为 true,则运行并报告活动而不写出结果。
--experimental-ivy EXPERIMENTAL: When true, creates a new app that uses the Ivy rendering engine. [实验性功能] 如果为 true,则创建一个使用 Ivy 渲染引擎的新应用程序。
--force (-f) When true, forces overwriting of existing files. 如果为 true,则强制覆盖现有文件。
--help Shows a help message for this command in the console. 在控制台中显示此命令的帮助消息。
--inline-style (-s) When true, includes styles inline in the component TS file. By default, an external styles file is created and referenced in the component TS file. 如果为 true,则在组件 TS 文件中包含内联样式。默认情况下,在组件 TS 文件中创建并引用外部样式文件。
--inline-template (-t) When true, includes template inline in the component TS file. By default, an external template file is created and referenced in the component TS file. 如果为 true,则在组件 TS 文件中包含模板内联。默认情况下,在组件 TS 文件中创建并引用外部模板文件。
--interactive When false, disables interactive input prompts. 如果为 false,则禁用交互式输入提示。
--minimal When true, creates a project without any testing frameworks. 如果为 true,则创建一个没有任何测试框架的项目。
--new-project-root The path where new projects will be created, relative to the new workspace root. 创建新项目的相对于新工作区根目录的路径。
--prefix (-p) The prefix to apply to generated selectors for the initial project. 要应用于初始项目的生成选择器的前缀。
--routing When true, generates a routing module for the initial project. 如果为 true,则为初始项目生成路由模块。
--skip-git (-g) When true, does not initialize a git repository. 如果为 true,则不初始化 git 存储库。
--skip-install When true, does not install dependency packages. 如果为 true,则不安装依赖包。
--skip-tests (-S) When true, does not generate “spec.ts” test files for the new project. 如果为 true,则不会为新项目生成“spec.ts”测试文件。
--style The file extension to use for style files. 用于样式文件的文件扩展名。
--verbose (-v) When true, adds more details to output logging. 如果为 true,则向输出日志记录添加更多详细信息
--view-encapsulation The view encapsulation strategy to use in the initial project. 在初始项目中使用的视图封装策略。

add 命令详细说明

用法:ng add <collection> [可选参数]

可选参数 简写 原文 中文描述
--defaults When true, disables interactive input prompts for options with a default. 如果为 true,则禁用具有默认选项的交互式输入提示。
--dry-run (-d) When true, runs through and reports activity without writing out results. 如果为 true,则运行并报告活动而不写出结果。
--force (-f) When true, forces overwriting of existing files. 如果为 true,则强制覆盖现有文件。
--help Shows a help message for this command in the console. 在控制台中显示此命令的帮助消息。
--interactive When false, disables interactive input prompts. 如果为 false,则禁用交互式输入提示。

generate 命令详细说明

用法:ng generate <schematic> [可选参数]

可选参数 简写 原文 中文描述
--defaults When true, disables interactive input prompts for options with a default. 如果为 true,则禁用具有默认选项的交互式输入提示。
--dry-run (-d) When true, runs through and reports activity without writing out results. 如果为 true,则运行并报告活动而不写出结果。
--force (-f) When true, forces overwriting of existing files. 如果为 true,则强制覆盖现有文件。
--help Shows a help message for this command in the console. 在控制台中显示此命令的帮助消息。
--interactive When false, disables interactive input prompts. 如果为 false,则禁用交互式输入提示。

默认可用的 Schematics(@schematics/angular):

  • appShell
  • application
  • class
  • component
  • directive
  • enum
  • guard
  • interface
  • library
  • module
  • pipe
  • service
  • serviceWorker
  • universal

serve 命令详细说明

用法:ng serve <project> [可选参数]

可选参数
(简写) | 原文 | 中文描述
— | — | — | —
--aot | Build using Ahead of Time compilation. | 使用提前编译(AOT)构建。
--base-href | Base url for the application being built. | 正在构建的应用程序的基本 URL。
--browser-target | Target to serve. | 伺服(运行)目标。
--build-event-log | (experimental) Output file path for Build Event Protocol events. | [实验性功能] 构建事件协议事件的输出文件路径。
--common-chunk | Use a separate bundle containing code used across multiple bundles. | 使用单独包,此包包含多个跨包使用的代码。
--configuration (-c) | 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. | 指定构建目标,在 angular.json 的 “configurations” 部分中指定。每个命名目标都附带该目标的选项默认配置。
--deploy-url | URL where files will be deployed. | 将要部署文件的 URL。
--disable-host-check | Don’t verify connected clients are part of allowed hosts. | 不验证连接的客户端是否为允许的主机。
--eval-source-map | Output in-file eval sourcemaps. | (译注:不知道啥意思)
--help | Shows a help message for this command in the console. | 在控制台中显示此命令的帮助消息。
--hmr | Enable hot module replacement. | 启用热模块替换。
--hmr-warning | Show a warning when the –hmr option is enabled. | 启用 –hmr 选项时显示警告。
--host | Host to listen on. | 要监听的主机。
--live-reload | Whether to reload the page on change, using live-reload. | 是否使用实时重新加载来重新加载页面。
--open (-o) | Opens the url in default browser. | 在默认浏览器中打开 URL。
–optimization | Enables optimization of the build output. | 启用构建输出优化。
--poll | Enable and define the file watching poll time period in milliseconds. | 启用并定义检查文件轮询的时间段(以毫秒为单位)。
--port | Port to listen on. | 要监听的端口。
--prod | 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. | 如果为 true,则将构建配置设置为生产目标。所有构建都使用捆绑和有限的 tree-shaking。生产构建还运行有限的死代码消除。
--progress | Log progress to the console while building. | 在构建时将进度记录到控制台。
--proxy-config | Proxy configuration file. | 代理配置文件。
--public-host | Specify the URL that the browser client will use. | 指定浏览器客户端将使用的 URL。
--serve-path | The pathname where the app will be served. | 应用程序的路径名。
--serve-path-default-warning | Show a warning when deploy-url/base-href use unsupported serve path values. | 当 deploy-url/base-href 使用不支持的路径时显示警告。
--source-map | Output sourcemaps. | 输出 sourcemaps。
--ssl | Serve using HTTPS. | 使用 HTTPS
--ssl-cert | SSL certificate to use for serving HTTPS. | 用于提供 HTTPS 的 SSL 证书。
--ssl-key |SSL key to use for serving HTTPS. | 用于提供 HTTPS 的 SSL 密钥。
--vendor-chunk | Use a separate bundle containing only vendor libraries. | 使用仅包含支持库(vendor libraries)的单独捆绑包。
--vendor-source-map | Resolve vendor packages sourcemaps. | 解决支持库(vendor libraries)的 sourcemaps。
--verbose | Adds more details to output logging. | 添加更多详细信息到输出日志记录。
--watch | Rebuild on change. | 当文件改变时重建。

build 命令详细说明

通常用法:ng b --prod --deploy-url /url/

用法:ng build <project> [可选参数]

可选参数
(简写) | 原文 | 中文描述
— | — | — | —
--aot | Build using Ahead of Time compilation. | 使用提前编译(AOT)构建。
--base-href | Base url for the application being built. | 正在构建的应用程序的基本 URL。
--build-event-log | (experimental) Output file path for Build Event Protocol events | [实验性功能] 构建事件协议事件的输出文件路径。
--build-optimizer | Enables ‘@angular-devkit/build-optimizer’ optimizations when using the ‘aot’ option. | 使用 ‘aot’ 选项时,启用 ‘@ angular-devkit/build-optimizer’ 优化。
--common-chunk | Use a separate bundle containing code used across multiple bundles. | 使用单独包,此包包含多个跨包使用的代码。
--configuration (-c) | 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. | 指定构建目标,在 angular.json 的 “configurations” 部分中指定。每个命名目标都附带该目标的选项默认配置。
--delete-output-path | Delete the output path before building. | 在构建之前删除输出路径。
--deploy-url | URL where files will be deployed. | 将要部署文件的 URL。
--eval-source-map | Output in-file eval sourcemaps. | (译注:不知道啥意思)
--extract-css | Extract css from global styles into css files instead of js ones. | 将全局样式的 css 提取为 css 文件而不是 js 文件。
--extract-licenses | Extract all licenses in a separate file. | 提取所有许可证到单独的文件中。
--fork-type-checker | Run the TypeScript type checker in a forked process. | 在分叉的进程中运行 TypeScript 类型检查器。
--help | Shows a help message for this command in the console. | 在控制台中显示此命令的帮助消息。
--i18n-file | Localization file to use for i18n. | 用于 i18n 的本地化文件。
--i18n-format | Format of the localization file specified with –i18n-file. | 使用 –i18n-file 指定的本地化文件的格式。
--i18n-locale | Locale to use for i18n. | 用于 i18n 的语言环境。
--i18n-missing-translation | How to handle missing translations for i18n. | 如何处理 i18n 缺失的翻译。
--index | The name of the index HTML file. | 入口 HTML 文件的名称。
--lazy-modules | List of additional NgModule files that will be lazy loaded. Lazy router modules will be discovered automatically. | 延迟加载的额外 NgModule 文件的列表。将自动发现延迟路由器模块。
--main | The full path for the main entry point to the app, relative to the current workspace. | 相对于当前工作空间的应用程序主入口点的完整路径。
--named-chunks | Use file name for lazy loaded chunks. | 使用延迟加载的块的文件名。
--ngsw-config-path | Path to ngsw-config.json. | ngsw-config.json 的路径
--optimization | Enables optimization of the build output. | 启用构建输出优化。
--output-hashing | Define the output filename cache-busting hashing mode. | (译注:不知道啥意思)
--output-path | 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. | 新输出目录的完整路径,相对于当前工作空间。 默认情况下,将输出写入当前项目中名为 dist / 的文件夹。
--poll | Enable and define the file watching poll time period in milliseconds. | 启用并定义检查文件轮询的时间段(以毫秒为单位)。
--polyfills | The full path for the polyfills file, relative to the current workspace. | polyfills 文件的完整路径,相对于当前工作空间。
--preserve-symlinks | Do not use the real path when resolving modules. | 解析模块时不要使用真实路径。
--prod | 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. | 如果为 true,则将构建配置设置为生产目标。所有构建都使用捆绑和有限的 tree-shaking。生产构建还运行有限的死代码消除。
--profile | Output profile events for Chrome profiler. | 为 Chrome profiler 提供输出配置事件
--progress | Log progress to the console while building. | 在构建时将进度记录到控制台。
--resources-output-path | The path where style resources will be placed, relative to outputPath. | 放置样式资源的路径,相对于 outputPath。
--service-worker | Generates a service worker config for production builds. | 生成一个生产环境的 service worker 配置。
--show-circular-dependencies | Show circular dependency warnings on builds. | 在构建中显示循环依赖警告。
--skip-app-shell | Flag to prevent building an app shell. | 跳过生成 app shell。
--source-map | Output sourcemaps. | 输出 sourcemaps。
--stats-json | Generates a ‘stats.json’ file which can be analyzed using tools such as: ‘webpack-bundle-analyzer’ or https://webpack.github.io/analyse. | 生成一个 status.json 文件,这个文件可以被工具用来分析,例如 ‘webpack-bundle-analyzer’ 或者 https://webpack.github.io/analyse。
–subresource-integrity | Enables the use of subresource integrity validation. | 启用子资源完整性验证。
--ts-config | The full path for the TypeScript configuration file, relative to the current workspace. | TypeScript 配置文件的完整路径,相对于当前工作空间。
--vendor-chunk | Use a separate bundle containing only vendor libraries. | 使用仅包含支持库(vendor libraries)的单独捆绑包。
--vendor-source-map | Resolve vendor packages sourcemaps. | 解决支持库(vendor libraries)的 sourcemaps。
--verbose | Adds more details to output logging. | 添加更多详细信息到输出日志记录。
--watch | Run build when files change. | 当文件改变时重建。

update 命令详细说明

用法:ng update [可选参数]

可选参数
(简写) | 原文 | 中文描述
— | — | — | —
--all | Whether to update all packages in package.json. | 更新 package.json 里所有的包
--force | If false, will error out if installed packages are incompatible with the update. | 如果为 false,已经安装的包与更新不兼容时将报错
--from | Version from which to migrate from. Only available with a single package being updated, and only on migration only. | 要从中迁移的版本。仅在更新单个程序包时可用,且仅在只进行迁移时才可用。
--help | Shows a help message for this command in the console. | 在控制台中显示此命令的帮助消息。
--migrate-only | Only perform a migration, does not update the installed version. | 仅执行迁移,不更新已安装的版本。
--next | Use the largest version, including beta and RCs. | 使用最大的版本号,包括 beta 和 RC。
--package-manager | The preferred package manager configuration files to use for registry settings. | 用于 registry 设置的首选包管理器配置文件。
--packages | The names of package(s) to update. | 要被更新的包的名字
--registry | The NPM registry to use. | 要使用的 NPM registry
--to | Version up to which to apply migrations. Only available with a single package being updated, and only on migrations only. Requires from to be specified. Default to the installed version detected. | 要应用迁移的版本。 仅适用于正在更新的单个程序包,且仅适用于只进行迁移。要求 from 参数已经指定。默认为检测到的已安装版本。
--verbose | Display additional details during the update process. | 在更新过程中显示更多的详细信息。