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）： // 假设通过构建参数传入环境名，例如：dotnet publish -c Release -p:BlazorEnvironment=Staging var builder = WebAssemblyHostBuilder.CreateDefault(args); var environment = builder.HostEnvironment.Environment; // 默认是 "Production"，也可从 JS 或 URL 参数注入 builder.Configuration.AddJsonFile($"appsettings.{environment}.json", optional: true, reloadOnChange: true);
统一管理环境标识：避免硬编码环境名
硬写
"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 则靠前端资源加载 + 构建时/运行时注入环境上下文。
