ng new
创建一个新工作空间和一个初始 Angular 应用。
Creates a new workspace and an initial Angular application.
ng new <name> [options]
ng n <name> [options]
说明
创建并初始化一个新的 Angular 应用程序,该应用程序是新工作区的默认项目。
Creates and initializes a new Angular application that is the default project for a new workspace.
提供交互式提示以提供可选配置,例如添加路由支持。可以放心地为所有提示选择其默认值。
Provides interactive prompts for optional configuration, such as adding routing support. All prompts can safely be allowed to default.
新的工作空间文件夹名称就是指定的项目名称,并且在顶层包含了配置文件。
The new workspace folder is given the specified project name, and contains configuration files at the top level.
默认情况下,新的初始应用程序(与工作空间名称相同)的文件放置在
src/
子文件夹中。相应的端到端测试位于e2e/
子文件夹中。By default, the files for a new initial application (with the same name as the workspace) are placed in the
src/
subfolder. Corresponding end-to-end tests are placed in thee2e/
subfolder.新应用程序的配置位于工作区配置文件
angular.json
中projects
部分的项目名称下。The new application's configuration appears in the
projects
section of theangular.json
workspace configuration file, under its project name.你在工作空间中生成的后续应用程序位于
projects/
子文件夹中。Subsequent applications that you generate in the workspace reside in the
projects/
subfolder.
如果你计划在工作空间中放多个应用程序,则可以通过将 --createApplication
选项设置为 false 来创建一个空的工作空间。然后,你可以使用 ng generate application
创建一个初始应用程序。这能让工作空间的名称不同于初始应用程序的名称,并确保所有应用程序都位于 /projects
子文件夹中,并与配置文件的结构匹配。
If you plan to have multiple applications in the workspace, you can create an empty workspace by setting the --createApplication
option to false. You can then use ng generate application
to create an initial application. This allows a workspace name different from the initial app name, and ensures that all applications reside in the /projects
subfolder, matching the structure of the configuration file.
参数
参数 | 说明 | Value Type |
---|---|---|
<name> | 新工作空间和初始项目的名称。 The name of the new workspace and initial project. | string |
选项
选项 | 说明 | Value Type | Default Value |
---|---|---|---|
--collection | 用来生成初始应用的一组原理图。 A collection of schematics to use in generating the initial application. 别名: -c | string | |
--commit | 初始 git 仓库提交信息。 Initial git repository commit information. | boolean | true |
--create-application | 在新工作区的 “src” 文件夹中创建一个新的初始应用程序项目。如果为 false,则会创建一个没有初始应用程序的空工作空间。然后,你可以使用 generate application 命令,以便让所有应用程序都创建在自己的项目文件夹中。 Create a new initial application project in the 'src' folder of the new workspace. When false, creates an empty workspace with no initial application. You can then use the generate application command so that all applications are created in the projects folder. | boolean | true |
--defaults | 对有默认值的选项禁用交互式输入提示。 Disable interactive input prompts for options with a default. | boolean | |
--directory | 要在其中创建工作空间的目录名称。 The directory name to create the workspace in. | string | |
--dry-run | 运行一遍并汇报其活动轨迹,但不真的写入任何结果。 Run through and reports activity without writing out results. 别名: -d | boolean | false |
--force | 强制覆盖现存文件。 Force overwriting of existing files. 别名: -f | boolean | false |
--help | 在控制台显示关于本命令的帮助信息。 Shows a help message for this command in the console. | true|false|json|JSON | false |
--inline-style | 在组件 TS 文件中包含内联样式。默认情况下,将创建一个外部样式文件,并在组件 TypeScript 文件中对其进行引用。 Include styles inline in the component TS file. By default, an external styles file is created and referenced in the component TypeScript file. 别名: -s | boolean | |
--inline-template | 在组件 TS 文件中包含内联模板。默认情况下,将创建一个外部模板文件,并在组件 TypeScript 文件中对其进行引用。 Include template inline in the component TS file. By default, an external template file is created and referenced in the component TypeScript file. 别名: -t | boolean | |
--interactive | 启用交互式输入提示。 Enable interactive input prompts. | boolean | |
--legacy-browsers | 使用差异化加载添加对 Internet Explorer 等旧版浏览器的支持。 Add support for legacy browsers like Internet Explorer using differential loading. | boolean | false |
--minimal | 创建没有任何测试框架的工作空间。(仅用于学习目的。) Create a workspace without any testing frameworks. (Use for learning purposes only.) | boolean | false |
--new-project-root | 要创建的新项目的路径。是相对于新工作空间根目录的。 The path where new projects will be created, relative to the new workspace root. | string | projects |
--package-manager | 用于安装依赖项的包管理器。 The package manager used to install dependencies. | npm|yarn|pnpm|cnpm | |
--prefix | 适用于初始项目的生成选择器的前缀。 The prefix to apply to generated selectors for the initial project. 别名: -p | string | app |
--routing | 为初始项目生成一个路由模块。 Generate a routing module for the initial project. | boolean | |
--skip-git | 不要初始化 git 仓库。 Do not initialize a git repository. 别名: -g | boolean | false |
--skip-install | 不要安装依赖包。 Do not install dependency packages. | boolean | false |
--skip-tests | 不要为新项目生成 “spec.ts” 测试文件。 Do not generate "spec.ts" test files for the new project. 别名: -S | boolean | false |
--strict | 创建带有更严格类型检查和更严格捆绑包预算设置的工作空间。此设置有助于提升可维护性,并预先捕获 BUG。欲知详情,参见 https://angular.cn/guide/strict-mode Creates a workspace with stricter type checking and stricter bundle budgets settings. This setting helps improve maintainability and catch bugs ahead of time. For more information, see https://angular.io/guide/strict-mode | boolean | false |
--style | 用于样式文件的扩展名/预处理器。 The file extension or preprocessor to use for style files. | css|scss|sass|less|styl | |
--verbose | 在输出日志中添加更多详情。 Add more details to output logging. 别名: -v | boolean | false |
--view-encapsulation | 用在初始项目中的视图封装策略。 The view encapsulation strategy to use in the initial project. | Emulated|Native|None|ShadowDom |