Angular构建后dist文件夹结构异常，无法适配AWS S3静态托管

我正在修读一门课程，要求将此前作业的Angular应用上传至AWS S3存储桶以部署静态站点。但构建后发现dist文件夹不符合预期：index.html不在根目录（这是AWS S3静态站点托管所需的），还生成了/browser和/server两个子文件夹。据我了解，标准的dist文件夹应在根目录包含index.html、assets文件夹及其他少量文件。为何我的构建结果与网上的默认结构不同？

dist文件夹结构截图：

angular.json文件内容：

{
  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
  "version": 1,
  "newProjectRoot": "projects",
  "projects": {
    "myFlix-Angular-client": {
      "projectType": "application",
      "schematics": {
        "@schematics/angular:component": {
          "style": "scss",
          "standalone": false
        },
        "@schematics/angular:directive": {
          "standalone": false
        },
        "@schematics/angular:pipe": {
          "standalone": false
        }
      },
      "root": "",
      "sourceRoot": "src",
      "prefix": "app",
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:application",
          "options": {
            "outputPath": "dist/my-flix-angular-client",
            "index": "src/index.html",
            "browser": "src/main.ts",
            "polyfills": [
              "zone.js"
            ],
            "tsConfig": "tsconfig.app.json",
            "inlineStyleLanguage": "scss",
            "assets": [
              "src/favicon.ico",
              "src/assets"
            ],
            "styles": [
              "src/styles.scss"
            ],
            "scripts": [],
            "server": "src/main.server.ts",
            "prerender": true,
            "ssr": {
              "entry": "server.ts"
            }
          },
          "configurations": {
            "production": {
              "budgets": [
                {
                  "type": "initial",
                  "maximumWarning": "500kb",
                  "maximumError": "1mb"
                },
                {
                  "type": "anyComponentStyle",
                  "maximumWarning": "2kb",
                  "maximumError": "4kb"
                }
              ],
              "outputHashing": "all"
            },
            "development": {
              "optimization": false,
              "extractLicenses": false,
              "sourceMap": true
            }
          },
          "defaultConfiguration": "production"
        },
        "serve": {
          "builder": "@angular-devkit/build-angular:dev-server",
          "configurations": {
            "production": {
              "buildTarget": "myFlix-Angular-client:build:production"
            },
            "development": {
              "buildTarget": "myFlix-Angular-client:build:development"
            }
          },
          "defaultConfiguration": "development"
        },
        "extract-i18n": {
          "builder": "@angular-devkit/build-angular:extract-i18n",
          "options": {
            "buildTarget": "myFlix-Angular-client:build"
          }
        },
        "test": {
          "builder": "@angular-devkit/build-angular:karma",
          "options": {
            "polyfills": [
              "zone.js",
              "zone.js/testing"
            ],
            "tsConfig": "tsconfig.spec.json",
            "inlineStyleLanguage": "scss",
            "assets": [
              "src/favicon.ico",
              "src/assets"
            ],
            "styles": [
              "src/styles.scss"
            ],
            "scripts": []
          }
        }
      }
    }
  },
  "cli": {
    "analytics": "8b2d4922-1479-470a-8e55-a41bcb2b5930"
  }
}

你的构建结果和默认结构不同，核心原因是你使用了Angular 16+引入的新应用构建器@angular-devkit/build-angular:application，并且开启了SSR（服务器端渲染）和预渲染功能：

• 这个新构建器默认会将浏览器端的静态文件输出到browser子目录，服务器端相关代码输出到server子目录，用于支持SSR或预渲染场景。
• 你在angular.json的build.options中配置了server、prerender: true和ssr参数，这些配置会触发SSR构建流程，进一步生成额外的子目录。
• 而网上常见的"标准dist结构"，是使用传统的@angular-devkit/build-angular:browser构建器生成的纯静态站点产物，这种产物会直接把index.html放在dist根目录。

针对AWS S3静态站点托管的需求，有两种可行方案：

方案1：直接上传browser目录内容（最快） #

不需要修改任何配置，构建完成后，进入dist/my-flix-angular-client/browser目录，把里面的所有文件（包括index.html、assets等）直接上传到AWS S3存储桶的根目录即可。S3静态站点托管会自动识别根目录下的index.html作为入口文件。

方案2：修改配置生成纯静态产物（彻底调整结构） #

如果你希望构建后直接在dist根目录得到静态文件，可以修改angular.json，关闭SSR并切换为传统构建逻辑：

1. 将architect.build.builder从@angular-devkit/build-angular:application改为@angular-devkit/build-angular:browser
2. 删除build.options中的server、prerender、ssr配置项
3. 将build.options里的browser字段改为main（对应传统构建器的入口配置）

修改后的build配置示例：

"build": {
  "builder": "@angular-devkit/build-angular:browser",
  "options": {
    "outputPath": "dist/my-flix-angular-client",
    "index": "src/index.html",
    "main": "src/main.ts",
    "polyfills": [
      "zone.js"
    ],
    "tsConfig": "tsconfig.app.json",
    "inlineStyleLanguage": "scss",
    "assets": [
      "src/favicon.ico",
      "src/assets"
    ],
    "styles": [
      "src/styles.scss"
    ],
    "scripts": []
  },
  "configurations": {
    "production": {
      "budgets": [
        {
          "type": "initial",
          "maximumWarning": "500kb",
          "maximumError": "1mb"
        },
        {
          "type": "anyComponentStyle",
          "maximumWarning": "2kb",
          "maximumError": "4kb"
        }
      ],
      "outputHashing": "all"
    },
    "development": {
      "optimization": false,
      "extractLicenses": false,
      "sourceMap": true
    }
  },
  "defaultConfiguration": "production"
}

修改后重新执行ng build，产物就会直接输出到dist/my-flix-angular-client根目录，符合你预期的标准结构。

内容的提问来源于stack exchange，提问作者Samuel Meyer