.NET Interactive 项目中的 DLL 引用问题分析与解决方案

在最新版本的 .NET Interactive 插件更新后，部分用户在使用 C# 和 F# 笔记本时遇到了 DLL 文件引用问题。这个问题主要表现为当使用 #r "路径\Example.dll" 语法引用本地 DLL 文件时，系统会抛出 CS1025 编译错误，提示"单行注释或行尾预期"。

问题现象

受影响的主要是以下两种场景：

1. 在 C# 笔记本中直接引用本地 DLL 文件路径
2. 在 F# 笔记本中混合使用本地 DLL 引用和 NuGet 包引用

值得注意的是，NuGet 包引用（如 #r "nuget: Microsoft.Data.SqlClient"）仍然可以正常工作，不受此问题影响。

问题根源

经过技术分析，这个问题与 .NET Interactive 最新版本对字符串字面量的处理方式变更有关。在更新后的版本中：

1. 普通的双引号字符串字面量（"路径\Example.dll"）会导致解析错误
2. 使用逐字字符串字面量（@"路径\Example.dll"）则可以正常工作

此外，该问题可能与 .NET 版本要求变更有关。最新版本的 .NET Interactive 需要 .NET 9 运行时环境，而部分用户引用的 DLL 可能是针对 .NET 8 或更早版本编译的。

临时解决方案

对于遇到此问题的用户，可以采取以下临时解决方案：

1. 修改引用语法：将普通字符串字面量改为逐字字符串字面量

   #r @"C:\路径\Example.dll"
   

2. 分离引用：在 F# 笔记本中，将本地 DLL 引用和 NuGet 包引用放在不同的单元格中执行

3. 降级版本：暂时回退到早期版本（如 1.0.5229040）以规避此问题

长期建议

对于开发者而言，建议：

1. 确保引用的 DLL 与当前 .NET 运行时版本兼容
2. 优先使用 NuGet 包引用而非直接 DLL 引用
3. 在必须使用本地 DLL 时，采用逐字字符串语法
4. 关注 .NET Interactive 的后续更新，官方可能会修复此兼容性问题

总结

这个 DLL 引用问题展示了开发工具链更新可能带来的兼容性挑战。通过理解问题本质并应用适当的解决方案，开发者可以继续高效地使用 .NET Interactive 进行交互式编程。同时，这也提醒我们在工具升级后需要关注 API 和行为变更，及时调整开发实践。