angular-cli 命令

1. 安装 Angular CLI

在使用 Angular CLI 之前,需要先安装 Node.js(推荐使用最新的 LTS 版本)。安装完成后,可以通过 npm 或 yarn 安装 Angular CLI:

bash
# 使用 npm 安装
npm install -g @angular/cli

# 使用 yarn 安装
yarn global add @angular/cli

# 验证安装是否成功
ng version

2. 项目创建与管理

创建新项目

bash
# 创建基础项目
ng new my-app

# 创建项目时指定样式格式(css/scss/less/sass)
ng new my-app --style=scss

# 创建项目时不初始化 git 仓库
ng new my-app --skip-git

# 创建项目时使用路由
ng new my-app --routing

# 创建项目时使用指定版本的 Angular
ng new my-app --version=12

切换到项目目录

bash
cd my-app

更新 Angular CLI

bash
# 更新全局 Angular CLI
npm uninstall -g @angular/cli
npm install -g @angular/cli@latest

# 更新项目中的 Angular CLI
ng update @angular/cli @angular/core

3. 代码生成

Angular CLI 可以快速生成各种 Angular 组件和服务:

生成组件

bash
# 生成基础组件
ng generate component my-component

# 简写形式
ng g c my-component

# 生成组件到指定目录
ng g c shared/my-component

# 生成组件时不创建测试文件
ng g c my-component --skip-tests

# 生成组件时使用内联模板和样式
ng g c my-component --inline-template --inline-style

生成服务

bash
# 生成基础服务
ng generate service my-service

# 简写形式
ng g s my-service

# 生成服务到指定目录
ng g s services/my-service

# 生成服务时使用 providedIn: 'root'
ng g s my-service --providedIn root

生成模块

bash
# 生成基础模块
ng generate module my-module

# 简写形式
ng g m my-module

# 生成带有路由的模块
ng g m my-module --routing

# 生成特性模块
ng g m features/my-feature --routing

生成其他代码

bash
# 生成指令
ng g d my-directive

# 生成管道
ng g p my-pipe

# 生成守卫
ng g guard my-guard

# 生成拦截器
ng g interceptor my-interceptor

# 生成解析器
ng g resolver my-resolver

# 生成类
ng g class my-class

# 生成接口
ng g interface my-interface

4. 开发与构建

启动开发服务器

bash
# 启动默认端口(4200)的开发服务器
ng serve

# 启动指定端口的开发服务器
ng serve --port 4300

# 启用实时重载
ng serve --live-reload

# 启用生产环境配置的开发服务器
ng serve --configuration production

# 简写形式
ng s
ng s -p 4300
ng s --prod

构建项目

bash
# 构建开发环境版本
ng build

# 构建生产环境版本
ng build --configuration production

# 简写形式
ng build --prod

# 构建指定环境的版本
ng build --configuration staging

# 构建时输出哈希值
ng build --output-hashing all

查看构建分析

bash
# 生成构建分析报告
ng build --prod --stats-json

# 使用 webpack-bundle-analyzer 查看报告
npx webpack-bundle-analyzer dist/my-app/stats.json

5. 测试与调试

运行单元测试

bash
# 运行所有单元测试
ng test

# 简写形式
ng t

# 运行指定的测试文件
ng test --include=src/app/my-component/my-component.spec.ts

# 运行测试并生成覆盖率报告
ng test --code-coverage

# 运行测试时不自动监视文件变化
ng test --watch=false

运行端到端测试

bash
# 启动开发服务器并运行端到端测试
ng e2e

# 简写形式
ng e

# 只运行端到端测试(需要先启动开发服务器)
ng e2e --dev-server-target=none

调试

bash
# 生成源映射文件
ng build --source-map

# 使用 VS Code 调试
# 在 launch.json 中配置调试选项

6. 部署

部署到 GitHub Pages

bash
# 安装 GitHub Pages 部署工具
npm install -g angular-cli-ghpages

# 构建并部署到 GitHub Pages
ng build --prod --base-href="/my-repo/"
ngh

部署到 Firebase

bash
# 安装 Firebase CLI
npm install -g firebase-tools

# 登录 Firebase
firebase login

# 初始化 Firebase 项目
firebase init

# 构建并部署到 Firebase
ng build --prod
firebase deploy

7. 其他常用命令

查看帮助

bash
# 查看所有可用命令
ng help

# 查看特定命令的帮助
ng serve --help
ng generate --help

检查代码格式

bash
# 安装 Prettier(如果尚未安装)
npm install --save-dev prettier

# 检查代码格式
npx prettier --check .

# 格式化代码
npx prettier --write .

添加依赖

bash
# 添加 Angular Material
ng add @angular/material

# 添加 PWA 支持
ng add @angular/pwa

# 添加 Bootstrap
npm install bootstrap
# 然后在 angular.json 中配置样式路径

移除依赖

bash
ng remove @angular/material

运行 lint 检查

bash
ng lint

# 自动修复 lint 错误
ng lint --fix

8. 配置文件

Angular CLI 项目的主要配置文件是 angular.json,它包含了项目的构建、测试、部署等配置信息。可以通过编辑这个文件来自定义项目的行为。

9. 常用技巧

  1. 别名设置:在 tsconfig.json 中配置路径别名,简化导入语句
  2. 环境配置:在 src/environments/ 目录下配置不同环境的变量
  3. 延迟加载:使用路由的延迟加载功能优化应用性能
  4. 代码分割:使用动态导入实现代码分割
  5. 自定义 schematics:创建自己的代码生成模板

10. 总结

Angular CLI 是 Angular 开发中不可或缺的工具,它提供了从项目创建到部署的完整工作流支持。掌握这些命令可以大大提高开发效率,减少重复工作。

如需了解更多详细信息,请访问 Angular CLI 官方文档

最后更新:2026-02-05