随着 .NET 10 预览版的技术细节逐步公开，一项看似不起眼但影响深远的改动引起了开发社区的广泛关注：用户配置文件的存储路径哈希算法（Url[hash]）发生了根本性变化。这意味着数百万依赖 ClickOnce 或 ApplicationSettingsBase 的 .NET 应用程序，其 user.config 文件的实际存放位置将被重新计算，进而可能影响配置的迁移、隔离和调试。

背景回顾：从“Url”到哈希路径

在传统 .NET Framework 中，基于 ClickOnce 部署的应用程序，其用户级别配置文件默认存储在 %LOCALAPPDATA%\Microsoft\<app_name>\<app_identity>_Url_<hash>\<version>\user.config 路径下。其中 <hash> 是通过对应用程序的部署 URL 或强名称进行哈希运算生成的 32 位十六进制字符串。这一设计本意是为了隔离不同来源或不同版本的同一应用，避免配置冲突。

进入 .NET Core / .NET 5+ 时代后，ClickOnce 被逐步边缘化，但 user.config 的路径生成算法仍沿用了旧版逻辑。然而，Net 10 团队在重构配置子系统时发现，旧哈希算法存在安全弱点：它基于 System.Security.Cryptography.HashAlgorithm.Create("SHA1") 实现，而 SHA-1 已被公认不够安全，且在不同操作系统上的实现细节不一致，导致同一应用在 Windows 与 Linux 下可能产生不同的哈希值。

.NET 10 中的新哈希计算方式

根据近期发布的 .NET 10 设计与文档（社区 issue 号），全新的哈希计算遵循以下原则：

  1. 算法升级：放弃 SHA-1，改用 SHA-256。这是目前行业推荐的密码学哈希标准，抗碰撞性更强，且跨平台行为一致。
  2. 输入内容调整：旧版只对部署 URL 进行哈希；新版则将 应用标识（如程序集名称、版本号） 也纳入计算。具体步骤为：
    - 构造规范化的标识字符串：<AppFullName>|<DeploymentUrl>|<Version>（若 ClickOnce 无 URL，则退化为 AppBase）。
    - 使用 UTF-8 编码该字符串。
    - 计算其 SHA-256 哈希值，并取前 16 个字节（128 位）作为路径标识。
  3. 输出格式：旧版输出 32 字符十六进制小写字符串；新版输出 32 字符十六进制小写字符串（因为 16 字节正好对应 32 个十六进制位），但内容完全不同。例如旧版为 e3b0c44298fc1c149afbf4c8996fb924，新版可能变为 a1b2c3d4e5f6...，且长度统一。
  4. 向后兼容：如果应用配置为“legacy”模式（通过 app.config 中的 UserConfigHashAlgorithm 开关），系统会尝试先读取旧路径，若不存在再使用新路径。但 .NET 10 默认启用新算法，因此已有 user.config 不会自动迁移到新位置——这也是开发者最需警惕的断崖式变化。

对开发者的实际影响

1. 配置丢失风险

如果一个应用从 .NET 8 升级到 .NET 10，旧版 user.config 存放在 ...\_Url_<old_hash>\ 下，而新版程序会去 ...\_Url_<new_hash>\ 下寻找配置。除非手动迁移文件，否则用户个性化设置（窗口位置、主题、数据库连接等）将全部恢复为默认值。

2. 调试与部署

  • 本地调试时，Visual Studio 可能因哈希不同而无法找到默认配置文件。
  • 持续集成/部署（CI/CD）中，若使用硬编码路径清理或备份配置，必须更新脚本。

3. 多版本共存

同一应用的不同版本（例如 1.0 与 2.0）将拥有完全独立的配置目录（因为版本号已被纳入哈希输入）。旧隔离设计反而被强化，但如果需要共享配置，开发者需自行实现迁移逻辑。

微软的官方建议

目前 .NET 团队在发布说明中建议：

  • 立即检查应用是否依赖 user.config 路径，尤其是 ClickOnce 遗留应用。
  • 在 app.config 中显式声明 <UserConfigHashAlgorithm>SHA1</UserConfigHashAlgorithm> 以恢复旧行为，但该选项将在未来版本中被淘汰。
  • 考虑迁移到更现代的配置方案，如 Microsoft.Extensions.Configuration 的 JSON/YAML 文件、或使用 ApplicationDataManager 等 API。

展望：配置管理的统一化

这一改动看似微小，却反映出 .NET 10 对“跨平台一致性”和“安全基线提升”的执着。从 .NET 5 起，Runtime 团队就开始系统性地清理历史遗留的 Windows 特定代码。新哈希算法只是冰山一角——后续我们可能会看到完全脱离 ClickOnce 路径模型的配置存储方案。对于开发者而言，与其修补旧路径依赖，不如趁早拥抱 .appsettings.json 等标准化配置框架，从根本上摆脱对 user.config 的耦合。

（本文基于 .NET 10 预览版 2 文档及 GitHub 议题整理，实际行为以最终正式版为准。）