Blazor应用按环境配置分Server与WASM两类：Server沿用ASP.NET Core机制，自动加载appsettings.{Environment}.json；WASM需手动AddJsonFile并注入环境名，敏感配置须后端提供。
Blazor 应用在不同环境（如开发、测试、生产）中使用不同配置，核心思路和 ASP.NET Core 一致：依靠 环境变量（ASPNETCORE_ENVIRONMENT） + 分环境的配置文件（appsettings.{Environment}.json），并结合 Blazor 的启动逻辑加载对应配置。
服务端渲染（Blazor Server）直接沿用 ASP.NET Core 配置机制
Blazor Server 是标准的 ASP.NET Core 应用，配置方式完全相同：
- 项目根目录下保留
appsettings.json（通用配置）和appsettings.Development.json、appsettings.Production.json等环境专属文件 - 确保这些文件的 “复制到输出目录”属性设为“如果较新则复制”
- 在
Program.cs中调用builder.Configuration加载配置，无需额外操作 —— 框架会自动根据ASPNETCORE_ENVIRONMENT值合并对应文件 - 例如，在开发环境下运行时，
appsettings.Development.json会自动覆盖appsettings.json中的同名键
WebAssembly（Blazor WASM）需手动加载环境配置文件
Blazor WASM 运行在浏览器中，没有服务器端环境变量，也不能直接读取本地文件系统。它通过 HTTP 请求加载 JSON 配置，因此要按环境区分，关键在于：
- 构建时生成对应环境的
appsettings.{Environment}.json文件（如appsettings.Staging.json）并部署到服务器同一目录下 - 在
Program.cs中显式调用configuration.AddJsonFile并传入带环境名的路径 - 环境名通常由构建参数或部署脚本控制，比如用 MSBuild 属性
$(Configuration)或自定义变量
示例（WASM 的 Program.cs）：
统一管理环境标识：避免硬编码环境名
硬写 "Development" 或 "Production" 容易出错。推荐做法：
- Blazor Server：依赖
IWebHostEnvironment.Environment（已内置） - Blazor WASM：通过
WebAssemblyHostBuilder.HostEnvironment.Environment获取（默认由index.html中的window["blazor-environment"]或构建时注入的__env决定） - 更可靠的方式是在发布前，用构建脚本（如 GitHub Actions、Azure DevOps 或 MSBuild Target）向
index.html注入环境标识，或通过 JS interop 读取location.hostname映射环境（例如dev.example.com → Development）
敏感配置不放 appsettings.json，用环境变量或密钥管理器
数据库连接字符串、API 密钥等不应提交到代码库：
- Blazor Server：用
dotnet user-secrets（开发）或操作系统级环境变量（生产）替代 JSON 中的敏感项 - Blazor WASM：切勿在客户端存储敏感配置 —— 所有密钥必须由后端 API 提供，前端只持 Token 或临时凭证
- 若 WASM 需要调用不同环境的后端地址，可将 API 基地址作为公开配置（如
ApiBaseUri）放在appsettings.{env}.json中，这是安全且常见的做法
基本上就这些。关键是分清 Blazor Server 和 WASM 的运行模型差异：Server 走标准 .NET 配置管道，WASM 则靠前端资源加载 + 构建时/运行时注入环境上下文。
