Contents

anglular隨意筆記

Angular CLI 是 Angular 框架的官方命令列工具,可以快速建立專案、產生各種元件、執行開發伺服器、建置打包等。以下整理 Angular CLI 常用指令和 Angular 開發的基本流程。

安裝 Angular CLI

1
npm install -g @angular/cli

確認安裝版本:

1
ng version

建立新專案

1
ng new my-app

執行後會詢問:

  • 是否加入 Angular Routing(建議 Y)
  • 使用哪種樣式表格式(CSS / SCSS / SASS / Less)

建立完成後,進入專案目錄:

1
cd my-app

啟動開發伺服器

1
ng serve

預設在 http://localhost:4200 啟動,支援 Hot Reload(修改程式碼自動重新整理)。

1
2
3
4
5
# 指定 port
ng serve --port 4201

# 開放外部連線
ng serve --host 0.0.0.0

程式碼產生器(ng generate)

建立 Component(元件)

1
2
3
ng generate component title
# 縮寫
ng g c title

會建立以下四個檔案:

  • title.component.ts:元件邏輯
  • title.component.html:模板
  • title.component.css:樣式
  • title.component.spec.ts:測試

建立 Directive(指令)

1
ng g directive todo

用途:自訂 HTML 屬性行為,例如 appHighlight 讓元素在 hover 時改變顏色。

建立 Pipe(管道)

1
ng g pipe pipe/my-filter

用途:轉換模板中的資料顯示格式,例如日期格式化、貨幣顯示。

建立 Service(服務)

1
ng g service services/data

服務用於處理商業邏輯、HTTP 請求、多元件間的資料共享,透過依賴注入(DI)使用。

建立 Interface(介面)

1
ng g interface post

定義資料型別,讓 TypeScript 能做型別檢查。

建立 Module(模組)

1
ng g module feature

將相關的元件、指令、服務分組為功能模組,有助於程式碼組織和懶加載(Lazy Loading)。

建置專案

1
2
3
4
5
# 開發環境建置
ng build

# 正式環境建置(最佳化)
ng build --configuration production

建置結果輸出到 dist/ 目錄,可直接部署到任何靜態網頁伺服器。

執行測試

1
2
3
4
5
# 單元測試(使用 Karma)
ng test

# E2E 測試
ng e2e

推薦的 VS Code 套件

開發 Angular 時,以下 VS Code 套件可大幅提升效率:

  • Angular Language Service:提供模板中的自動補全、型別檢查、錯誤提示
  • Angular TypeScript Snippets:提供 Angular 常用程式碼片段
  • Prettier - Code formatter:自動格式化程式碼,統一團隊風格

典型 Angular 開發流程

1
2
3
4
5
6
7
ng new project-name          # 建立專案
ng g module feature          # 建立功能模組
ng g component feature/list  # 建立元件
ng g service feature/api     # 建立 API 服務
ng g interface feature/model # 建立資料介面
ng serve                     # 開發中
ng build --configuration production  # 準備部署

參考資料