进行翻译时的 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 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. 在更新过程中显示更多的详细信息。