Angular JA 项目启动与配置教程

2025-05-16 14:42:16作者：柯茵沙

1. 项目目录结构及介绍

Angular JA 的目录结构遵循 Angular 项目的标准布局，以下是一些主要目录和文件的介绍：

src/：源代码目录，包含项目的所有代码。
- assets/：存放静态资源，如图标、图片等。
- app/：应用的主要目录，包含组件、模型、服务、模块等。
  - components/：存放所有组件的代码。
  - models/：定义数据模型。
  - services/：存放业务逻辑和数据处理的服务。
  - shared/：共享模块和工具类。
- environments/：环境配置文件，用于不同环境下的配置。
- index.html：应用的入口 HTML 文件。
- main.ts：应用的入口 TypeScript 文件。
- styles.css：全局样式表。
e2e/：端到端测试目录。
node_modules/：存放项目依赖的第三方库。
angular.json：Angular CLI 的配置文件。
package.json：项目的包配置文件，包含项目依赖和脚本。
tsconfig.json：TypeScript 编译器的配置文件。
karma.conf.js：Karma 测试配置文件。
protractor.conf.js：Protractor 端到端测试配置文件。

2. 项目的启动文件介绍

项目的启动文件主要包括 src/main.ts 和 src/index.html。

src/main.ts：这是应用的入口 TypeScript 文件。它负责引导整个应用的启动过程，包括加载 Angular 的核心库、应用模块以及启动 Angular 应用。

import { enableProdMode } from '@angular/core';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';

import { AppModule } from './app/app.module';
import { environment } from './environments/environment';

if (environment.production) {
  enableProdMode();
}

platformBrowserDynamic().bootstrapModule(AppModule)
  .catch(err => console.error(err));

src/index.html：这是应用的入口 HTML 文件。它包含一个用于启动应用的 <script> 标签，并定义了应用的根元素。

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Angular JA</title>
  <base href="/">
  <link rel="icon" type="image/x-icon" href="favicon.ico">
</head>
<body>
  <app-root></app-root>
  <script src="main.ts"></script>
</body>
</html>

3. 项目的配置文件介绍

项目的配置文件主要包括 angular.json 和 package.json。

angular.json：这是 Angular CLI 的配置文件，它定义了项目结构和构建选项。例如，它可以定义不同的构建环境（开发、生产等）以及相应的配置。

{
  "version": 1,
  "projects": {
    "angular-ja": {
      "architect": {
        "schematic": {
          "@schematics/angular:component": {
            "prefix": "app",
            "style": "css"
          }
        },
        "build": {
          "options": {
            "outputPath": "dist/angular-ja",
            "index": "src/index.html",
            "main": "src/main.ts",
            "polyfills": "src/polyfills.ts",
            "tsConfig": "tsconfig.app.json",
            "aot": true,
            "assets": [
              "src/favicon.ico",
              "src/assets"
            ],
            "styles": [
              "src/styles.css"
            ],
            "scripts": []
          }
        }
      }
    }
  }
}

package.json：这是 Node.js 项目的配置文件，它定义了项目的依赖、脚本和元数据。例如，它包含了用于启动开发服务器、构建项目等操作的命令。

{
  "name": "angular-ja",
  "version": "0.0.0",
  "scripts": {
    "start": "ng serve",
    "build": "ng build",
    "test": "ng test",
    "lint": "ng lint",
    "e2e": "ng e2e"
  },
  "private": true,
  "dependencies": {
    "@angular/common": "^13.0.0",
    "@angular/core": "^13.0.0",
    "@angular/forms": "^13.0.0",
    "@angular/platform-browser": "^13.0.0",
    "@angular/platform-browser-dynamic": "^13.0.0",
    "@angular/router": "^13.0.0",
    ...
  },
  "devDependencies": {
    "@angular/cli": "^13.0.0",
    "@angular-devkit/build-angular": "^13.0.0",
    ...
  }
}