无需重新部署，如何修改SharePoint WebPart的web.config配置？

前提说明 #

web.config是SharePoint Web应用程序级的配置文件，修改前务必备份原文件，避免配置错误导致站点异常。针对不同SharePoint环境，操作方式略有区别：

一、本地SharePoint服务器环境（如SP2013/2016/2019） #

1. 定位目标web.config文件 #

找到对应Web应用程序的物理路径，通常位于C:\inetpub\wwwroot\wss\VirtualDirectories\<Web应用程序端口号>目录下，找到web.config文件。

2. 修改配置节点 #

根据WebPart需要调整的设置，找到对应配置节修改：

• 若为自定义AppSettings节点：直接修改<appSettings>下的目标键值对，示例：

  <appSettings>
    <add key="WebPart.MaxDisplayItems" value="15" /> <!-- 修改此处value值 -->
  </appSettings>
  

• 若为自定义配置节：找到对应节节点修改内容，确保格式与原有配置一致。

3. 应用配置变更 #

保存修改后的文件，SharePoint会自动检测到配置变化并重新加载，无需重启IIS。若修改了关键节点，建议在低峰时段回收对应应用程序池。

二、SharePoint Online环境 #

SharePoint Online不允许直接修改web.config，可通过以下动态配置方案替代：

1. 用SharePoint列表存储配置 #

• 在站点创建自定义列表（如WebPartConfigs），添加ConfigKey、ConfigValue等字段。
• 在WebPart代码中，通过SPFx的REST API或PnP JS从该列表读取配置值，替代原web.config中的硬编码内容。

2. 使用租户/站点属性 #

• 租户级配置可通过SharePoint管理中心设置租户属性；站点级配置使用站点属性。
• 在WebPart代码中，通过web.getAllProperties()或PnP JS获取属性值，实现动态读取配置。

注意事项 #

• 本地多服务器场环境中，修改web.config后需确保所有前端服务器的配置文件保持一致。
• 所有配置修改需先在测试环境验证，避免影响生产站点。
• 频繁变动的配置优先采用外部存储（列表、属性）方案，减少对web.config的直接操作。

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