Azure App Service应用设置如何插入换行符？长文本配置方案是什么？

一、如何在Azure门户的应用设置中插入换行符 #

Azure门户的应用设置文本框是纯文本输入环境，直接输入\n不会被自动转义为换行符。我之前踩过这个坑，正确的处理方式是：

• 直接在文本框中按下Enter键输入实际换行，保存配置后，应用读取该值时会自动识别为换行符。比如在C#中通过Environment.GetEnvironmentVariable("YourSettingName")读取到的字符串，就会包含真实的换行，不需要额外转义处理。
• 补充说明：如果是通过Azure CLI或ARM模板配置，\n是有效的，但门户端必须用实际回车来输入换行。

二、长文本配置的推荐方案（适配VSTS持续集成，避免构建转换） #

结合你不想在VSTS构建过程中执行文本转换的需求，推荐以下几种无需改动构建流程的方案：

1. 使用Azure App Configuration

这是Azure专门的应用配置管理服务，完美适配长文本场景：

• 在Azure门户创建App Configuration实例，将长文本直接存入键值对中，支持分层管理、标签区分等功能；
• 应用中添加App Configuration的SDK依赖，直接从服务端读取配置；
• 集成VSTS时，只需确保应用能通过身份验证访问该服务（比如配置服务连接），完全不需要修改构建环节。

2. 使用Azure Key Vault（适合敏感长文本）

如果你的长文本包含敏感信息，Key Vault是更安全的选择：

• 在Key Vault中创建一个「秘密（Secret）」，将长文本存入；
• 在App Service的应用设置中，新增配置项，值填写@Microsoft.KeyVault(SecretUri=你的秘密URI)，App Service会自动从Key Vault拉取对应值；
• 整个过程不需要构建介入，应用读取该配置项时就能拿到完整的长文本。

3. Base64编码（无需额外服务）

如果不想引入新的Azure服务，可以用Base64编码绕过长文本输入限制：

• 本地将长文本转换为Base64字符串（比如用C#代码Convert.ToBase64String(Encoding.UTF8.GetBytes("你的长文本"))，或者在线工具转换）；
• 在Azure门户的应用设置中输入编码后的字符串；
• 应用读取到值后，再解码回原文本：Encoding.UTF8.GetString(Convert.FromBase64String(读取到的配置值))；
• 这个方案只需要在应用代码中添加一行解码逻辑，完全不涉及VSTS构建转换。

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