Spec-Zone.ru › Angular

new

ng new [name] [options]
ng n [name] [options]

Создает и инициализирует новое приложение Angular, которое является проектом по умолчанию для новой рабочей области.

Предлагает интерактивные запросы для настройки дополнительных параметров, например добавления поддержки маршрутизации. Для всех запросов можно безопасно оставить значения по умолчанию.

  • Новая папка рабочей области получает указанное имя проекта и содержит файлы конфигурации в корневом каталоге.

  • По умолчанию файлы нового начального приложения (с тем же именем, что и у рабочей области) размещаются во вложенной папке src/.

  • Конфигурация нового приложения отображается в разделе projects файла конфигурации рабочей области angular.json под именем проекта.

  • Последующие приложения, создаваемые в рабочей области, размещаются во вложенной папке projects/.

Если в рабочей области планируется разместить несколько приложений, можно создать пустую рабочую область с помощью параметра --no-create-application. Затем можно использовать ng generate application для создания начального приложения. Это позволяет задать имя рабочей области, отличное от имени начального приложения, и гарантирует, что все приложения будут размещены во вложенной папке /projects в соответствии со структурой файла конфигурации.

Аргументы

name

Имя новой рабочей области и начального проекта. Это имя будет использоваться для корневого каталога и различных идентификаторов в проекте.

Тип значения

string

Параметры

ai-config

Указывает, для каких инструментов ИИ следует создать файлы конфигурации. Эти файлы помогают улучшить результаты работы инструментов ИИ благодаря соблюдению рекомендаций.

Тип значения

array

Допустимые значения

agents, claude, copilot, cursor, gemini, jetbrains, none, windsurf

collection

Коллекция схем, используемых для создания начального приложения.

Тип значения

string

commit

Настраивает первоначальный коммит Git для нового репозитория.

Тип значения

boolean

По умолчанию

true

create-application

Создает начальный проект приложения в новой рабочей области. Если значение равно false, создается пустая рабочая область без начального приложения. Затем можно использовать команду ng generate application для создания приложений в каталоге projects.

Тип значения

boolean

По умолчанию

true

defaults

Отключает интерактивные запросы для параметров, имеющих значение по умолчанию.

Тип значения

boolean

По умолчанию

false

directory

Каталог, в котором следует создать новую рабочую область и проект. Если он не указан, рабочая область будет создана в текущем каталоге.

Тип значения

string

dry-run

Выполняет пробный запуск и сообщает о действиях, не записывая результаты.

Тип значения

boolean

По умолчанию

false

file-name-style-guide

Соглашение об именовании файлов для создаваемых файлов. Стиль «2025» (по умолчанию) использует краткий формат (например, app.ts для корневого компонента), а стиль «2016» включает тип в имя файла (например, app.component.ts). Дополнительные сведения см. в руководстве по стилю Angular (https://angular.dev/style-guide).

Тип значения

string

Допустимые значения

2016, 2025

По умолчанию

2025

force

Принудительно перезаписывает существующие файлы.

Тип значения

boolean

По умолчанию

false

help

Выводит справочное сообщение об этой команде в консоль.

Тип значения

boolean

inline-style

Включает стили корневого компонента начального приложения непосредственно в файл app.ts. По умолчанию создается отдельный файл таблицы стилей (например, app.css).

Тип значения

boolean

inline-template

Включает HTML-шаблон корневого компонента начального приложения непосредственно в файл app.ts. По умолчанию создается отдельный файл шаблона (например, app.html).

Тип значения

boolean

interactive

Включает интерактивные запросы ввода.

Тип значения

boolean

По умолчанию

true

minimal

Создает минимальную рабочую область Angular без каких-либо средств тестирования. Этот вариант предназначен для обучения и простых экспериментов, а не для производственных приложений.

Тип значения

boolean

По умолчанию

false

new-project-root

Путь относительно корневого каталога рабочей области, в котором будут создаваться новые проекты. По умолчанию новые проекты создаются в каталоге projects.

Тип значения

string

По умолчанию

projects

package-manager

Менеджер пакетов, используемый для установки зависимостей.

Тип значения

string

Допустимые значения

bun, npm, pnpm, yarn

prefix

Префикс для селекторов, создаваемых для начального проекта. Например, если префикс — my-app, а создаваемый компонент называется my-component, селектор будет my-app-my-component.

Тип значения

string

По умолчанию

app

routing

Включает маршрутизацию в начальном проекте приложения. Настраивает необходимые файлы и модули для управления навигацией между различными представлениями приложения.

Тип значения

boolean

skip-git

Не инициализирует репозиторий Git в новой рабочей области. По умолчанию репозиторий Git инициализируется, чтобы упростить отслеживание изменений проекта.

Тип значения

boolean

По умолчанию

false

skip-install

Пропускает автоматическую установку пакетов. Позже зависимости потребуется установить вручную.

Тип значения

boolean

По умолчанию

false

skip-tests

Пропускает создание файлов модульных тестов spec.ts.

Тип значения

boolean

По умолчанию

false

ssr

Настраивает начальное приложение для серверного рендеринга (SSR) и генерации статического сайта (SSG/предварительного рендеринга).

Тип значения

boolean

standalone

Создает приложение на основе standalone API, без NgModules.

Тип значения

boolean

По умолчанию

true

strict

Включает более строгую проверку типов и более строгие ограничения на размер сборки. Эта настройка помогает упростить сопровождение и выявлять ошибки на ранних этапах. Дополнительные сведения см. в разделе https://angular.dev/tools/cli/template-typecheck#strict-mode

Тип значения

boolean

По умолчанию

true

style

Тип файлов таблиц стилей, создаваемых для компонентов начального проекта.

Тип значения

string

Допустимые значения

css, less, sass, scss, tailwind

test-runner

Средство запуска модульных тестов.

Тип значения

string

Допустимые значения

karma, vitest

По умолчанию

vitest

view-encapsulation

Задает режим инкапсуляции представления для компонентов начального проекта. Он определяет область действия стилей компонентов и способ их применения. Доступны следующие варианты: Emulated (по умолчанию, стили ограничены компонентом), None (стили глобальные) и ShadowDom (стили инкапсулируются с помощью Shadow DOM).

Тип значения

string

Допустимые значения

Emulated, None, ShadowDom

zoneless

Создает начальное приложение, которое не использует zone.js.

Тип значения

boolean

Super-powered by Google ©2010–2025.
Code licensed under an MIT-style License. Documentation licensed under CC BY 4.0.
https://angular.dev/cli/new

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API