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）：
Kuwebs企业网站管理系统3.1.5 UTF8
下载
酷纬企业网站管理系统Kuwebs是酷纬信息开发的为企业网站提供解决方案而开发的营销型网站系统。在线留言模块、常见问题模块、友情链接模块。前台采用DIV+CSS，遵循SEO标准。 1.支持中文、英文两种版本，后台可以在不同的环境下编辑中英文。 3.程序和界面分离，提供通用的PHP标准语法字段供前台调用，可以为不同的页面设置不同的风格。 5.支持google地图生成、自定义标题、自定义关键词、自定义描
统一管理环境标识：避免硬编码环境名
硬写 "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 则靠前端资源加载 + 构建时/运行时注入环境上下文。
