.NET SDK 9.0.200 在 MacOS 上路径特殊字符导致的模板安装问题解析

在 .NET SDK 9.0.200 版本中，MacOS 用户在使用 dotnet new install 命令安装模板时，如果路径中包含特殊字符（特别是 @ 符号），会遇到模板安装失败的问题。这个问题主要影响使用 HomeBrew 安装的 Azure Functions Core Tools 等场景。

问题背景

.NET SDK 9.0.200 引入了一个新特性：支持使用 package@version 语法来安装模板包。这个改进旨在提供更一致和清晰的 CLI 体验。然而，这个改变意外影响了文件路径中包含 @ 符号的情况。

问题表现

当用户在 MacOS 上执行以下操作时会出现问题：

1. 创建一个包含 @ 符号的路径（如 repro@4）
2. 将模板包放入该路径
3. 尝试使用绝对路径安装该模板包

系统会错误地将路径中的 @ 符号解析为版本分隔符，而不是作为路径的一部分，导致安装失败。

技术分析

问题的根源在于模板引擎对输入路径的处理逻辑发生了变化。在 9.0.200 版本中：

• 对于明确的包名（如 Microsoft.Azure.Functions.Worker.ProjectTemplates），package@version 语法工作正常
• 但对于文件路径（特别是包含 @ 符号的路径），系统错误地尝试将其解析为包名和版本

这实际上是一个回归问题，因为文件路径安装是模板开发和工作流测试中的常见用例。

解决方案

开发团队已经确认这是一个需要修复的 bug，而不是预期的行为变更。正确的行为应该是：

• 对于明确的包名，继续支持 package@version 语法
• 对于文件路径，应该直接安装指定路径的包，而不进行特殊解析

影响范围

这个问题主要影响：

1. 使用 HomeBrew 安装 Azure Functions Core Tools 的用户
2. 在路径中包含 @ 符号的其他场景
3. 使用 .NET SDK 9.0.200 及以上版本的 MacOS 用户

临时解决方案

在官方修复发布前，用户可以：

1. 暂时降级到 .NET SDK 9.0.102 版本
2. 避免在模板安装路径中使用 @ 符号
3. 等待即将发布的修复版本

总结

这个问题展示了在改进 CLI 一致性时可能带来的意外副作用。开发团队已经意识到这个问题的重要性，特别是考虑到它对 Azure Functions 工作流的重大影响。未来版本将会区分对待包名和文件路径的处理，确保两种场景都能正常工作。

对于依赖模板安装功能的开发者，建议关注 .NET SDK 的更新公告，以获取该问题的修复信息。