Angular构建配置异常：始终选用production环境问题排查

以下是几种常见的原因及解决办法：

1. 环境替换规则配置错误 #

检查angular.json中各环境的fileReplacements路径是否正确，且替换方向无误。正确的配置示例如下：

"projects": {
  "your-project-name": {
    "architect": {
      "build": {
        "configurations": {
          "development": {
            "fileReplacements": [
              {
                "replace": "src/environments/environment.ts",
                "with": "src/environments/environment.development.ts"
              }
            ],
            "optimization": false,
            "sourceMap": true
          },
          "production": {
            "fileReplacements": [
              {
                "replace": "src/environments/environment.ts",
                "with": "src/environments/environment.prod.ts"
              }
            ],
            "optimization": true,
            "sourceMap": false
          }
        }
      }
    }
  }
}

• 确认replace指向默认环境文件（通常是environment.ts），with指向对应环境的目标文件；
• 检查文件路径拼写是否正确，比如environments是否写错，文件是否实际存在于指定路径。

2. package.json脚本未指定正确配置 #

确保脚本命令中通过--configuration参数明确指定环境，示例如下：

"scripts": {
  "build:dev": "ng build --configuration development",
  "build:prod": "ng build --configuration production"
}

如果脚本遗漏该参数，即使angular.json设置了defaultConfiguration，也可能因缓存或机制问题导致配置不生效。

3. 环境文件内容或命名混淆 #

• 确认environment.development.ts中的配置为开发环境属性，比如production: false，避免误将生产环境内容复制到该文件；
• Angular 14+版本默认使用environment.development.ts作为开发环境文件，若项目从旧版本升级而来，需确认是否保留旧命名规则（比如旧版本直接用environment.ts作为开发环境）导致冲突。

4. 清理构建缓存 #

缓存可能导致配置未更新，执行以下操作后重新构建：

• 删除项目根目录下的dist文件夹；
• 删除.angular/cache目录；
• 执行ng build --clean命令强制清理缓存构建。

5. defaultConfiguration位置错误 #

确认defaultConfiguration配置在build节点下，与configurations同级，而非嵌套在options中，正确位置示例：

"architect": {
  "build": {
    "builder": "@angular-devkit/build-angular:browser",
    "options": { /* 基础配置 */ },
    "defaultConfiguration": "development",
    "configurations": { /* 各环境配置 */ }
  }
}

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