在.NET Framework的Web应用程序里，Web.config是最常用的配置文件，其中的appSettings节点专门用于保存简单的键值对设置。借助它，我们可以把容易变动的参数从代码中剥离出来，降低发布和维护成本。
appSettings的基本结构
appSettings位于configuration节点下，使用add元素来定义具体的键和值，key表示配置名，value表示配置内容。示例如下：
<configuration>
<appSettings>
<add key="SiteName" value="我的测试站点" />
<add key="ApiUrl" value="https://www.ipipp.com/api" />
<add key="IsDebug" value="true" />
</appSettings>
</configuration>
在代码中读取配置
在C#后端代码中，可以使用ConfigurationManager类来读取appSettings里的键值。需要注意引用System.Configuration程序集。
using System.Configuration;
string siteName = ConfigurationManager.AppSettings["SiteName"];
string apiUrl = ConfigurationManager.AppSettings["ApiUrl"];
bool isDebug = bool.Parse(ConfigurationManager.AppSettings["IsDebug"]);
// 如果键可能不存在，建议先做判断
string timeout = ConfigurationManager.AppSettings["Timeout"];
if (!string.IsNullOrEmpty(timeout))
{
int seconds = int.Parse(timeout);
}
使用注意事项
- 修改Web.config后，IIS站点会自动重启，线上环境应避免频繁改动。
- 敏感信息如密码不建议明文写在appSettings中，可结合加密配置节处理。
- 键名建议统一规范，避免和其他配置冲突。
常见配置场景对比
| 场景 | 是否适合放appSettings | 说明 |
|---|---|---|
| 功能开关 | 适合 | 修改后无需重新编译 |
| 数据库连接串 | 一般放connectionStrings | 有专门节点更安全 |
| 第三方接口地址 | 适合 | 便于多环境切换 |
通过代码动态写入
虽然不常用，但也可以通过Configuration对象保存配置，示例如下：
using System.Configuration;
Configuration config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
config.AppSettings.Settings["SiteName"].Value = "新站点名";
config.Save(ConfigurationSaveMode.Modified);
ConfigurationManager.RefreshSection("appSettings");
总体来看，appSettings是.NET Web应用中最轻量的配置方式，理解它的结构和读取方法，能让你更从容地管理应用程序的运行参数。
Web.configappSettings.NET修改时间：2026-07-25 22:54:25