RoslynPad中处理CSX脚本的元数据引用问题

在RoslynPad项目中，用户在使用CSX脚本时遇到了一个常见问题：当通过#load指令加载其他CSX文件时，如果被加载的文件中包含#r元数据引用指令，会导致"Metadata references are not supported"错误。这个问题源于Roslyn脚本引擎对嵌套元数据引用的处理限制。

问题本质分析

CSX脚本是C#脚本文件，RoslynPad使用Roslyn编译器来执行这些脚本。#load指令允许脚本包含其他脚本文件的内容，类似于C#中的源代码包含。然而，当被加载的脚本中包含#r指令（用于添加程序集引用）时，Roslyn脚本引擎无法正确处理这些嵌套的元数据引用。

临时解决方案

开发者提供了两种临时解决方案，都涉及修改RoslynPad的源代码：

方案一：脚本合并与预处理

第一种方法是通过修改ExecutionHost.cs文件，添加一个代码预处理器，在脚本执行前：

1. 查找所有#load指令并加载对应文件内容
2. 将这些内容直接合并到主脚本中
3. 重新组织using和#r指令，确保它们位于脚本开头

这种方法实质上是将多个脚本文件合并为一个，避免了嵌套引用的问题，但可能会影响脚本的模块化结构。

方案二：引用文件转换

第二种更完善的解决方案是：

1. 创建被加载脚本的临时副本（.nor文件）
2. 在这些副本中将#r指令注释掉（改为//#r）
3. 修改主脚本中的#load指令指向这些临时文件

这种方法保留了原始脚本的结构，同时解决了元数据引用问题。它还递归处理多层嵌套的#load指令，确保所有层级的引用都被正确处理。

技术实现细节

在第二种方案中，关键函数getLoadCSXCode实现了以下逻辑：

1. 使用正则表达式匹配所有#load指令
2. 为每个被加载的脚本创建.nor临时文件
3. 递归处理嵌套的#load指令
4. 确保顶层脚本保留原始#load指令以便后续触发

这种方法既解决了当前执行问题，又保持了原始脚本的可用性，因为顶层脚本仍然可以直接运行而不需要预处理。

对开发者的建议

虽然这些临时解决方案可以解决问题，但从长远来看，建议：

1. 考虑将这些修改贡献给RoslynPad主项目
2. 或者等待Roslyn脚本引擎未来版本对嵌套元数据引用的原生支持
3. 在复杂项目中，考虑将共享代码编译为程序集，然后通过#r引用，而不是使用#load

这些解决方案展示了在遇到框架限制时的创造性思维，同时也提醒我们在设计脚本架构时要考虑工具链的限制。