如何像配置环境变量（ENV vars）一样在运行时配置SPFX扩展？

SharePoint Online作为托管服务，确实没有像自建Node/Express服务器那样直接配置环境变量的原生功能，但有几个实用的变通方案可以满足类似需求：

1. 站点自定义属性 #

在站点设置中添加自定义属性来存储环境变量：

• 操作路径：站点设置 > 站点信息 > 查看所有站点设置 > 站点属性，添加键值对形式的自定义属性
• 通过代码读取：比如在SPFx中可以这样获取：

  this.context.site.get().then(site => {
    const envVar = site.properties.your_custom_variable_key;
    // 使用变量
  });
  

• 适用场景：站点级别的全局变量，配置简单，权限可控。

2. 专用配置列表 #

创建一个专门的列表存储环境配置项：

• 新建列表（比如命名为EnvironmentSettings），添加Key（单行文本）和Value（多行文本/单行文本）字段，还可新增Environment字段区分开发/生产环境
• 通过REST API或SPFx读取：

  // REST API示例
  fetch(`${this.context.pageContext.web.absoluteUrl}/_api/web/lists/getbytitle('EnvironmentSettings')/items?$filter=Key eq 'API_KEY'`, {
    headers: { 'Accept': 'application/json;odata=nometadata' }
  }).then(res => res.json()).then(data => {
    const apiKey = data.value[0].Value;
  });
  

• 适用场景：需要灵活维护多环境配置、支持多人协作管理的场景。

3. SPFx 部件属性包 #

如果是开发SPFx web部件或扩展，可以利用部件的属性配置：

• 在SPFx部件的manifest.json中定义可配置属性，部署时针对不同环境设置对应值
• 也可使用租户级属性包（需管理员权限）存储全局变量，通过SPFx读取租户属性
• 适用场景：与SPFx解决方案绑定的环境变量，部署阶段即可区分环境配置。

4. Azure Key Vault 集成（敏感数据专用） #

对于API密钥、连接字符串等敏感信息，推荐用Azure Key Vault存储：

• 将敏感变量存入Key Vault，配置Azure AD权限允许SharePoint相关应用访问
• 通过SPFx或Azure AD应用调用Key Vault API获取值
• 适用场景：企业级敏感数据的安全存储，符合合规要求。

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