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. 常用技巧
- 别名设置:在
tsconfig.json中配置路径别名,简化导入语句 - 环境配置:在
src/environments/目录下配置不同环境的变量 - 延迟加载:使用路由的延迟加载功能优化应用性能
- 代码分割:使用动态导入实现代码分割
- 自定义 schematics:创建自己的代码生成模板
10. 总结
Angular CLI 是 Angular 开发中不可或缺的工具,它提供了从项目创建到部署的完整工作流支持。掌握这些命令可以大大提高开发效率,减少重复工作。
如需了解更多详细信息,请访问 Angular CLI 官方文档。
最后更新:2026-02-05