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