CSharpScript.EvaluateAsync报“Cannot resolve symbol”根本原因是脚本上下文未声明类型或引用缺失；Roslyn默认仅加载System和System.Core，需显式添加程序集引用和命名空间导入。
为什么 CSharpScript.EvaluateAsync 会报 “Cannot resolve symbol”
根本原因不是语法错，而是脚本上下文没声明类型或引用缺失。Roslyn 脚本默认只加载 System 和 System.Core，连 List<T> 都得手动加 using，更别说你项目里的自定义类。
实操建议：
- 用
CSharpScript.Create显式传入ScriptOptions，调用WithReferences加入程序集（比如typeof(List<int>).Assembly） - 用
WithImports补全命名空间，new[] { "System.Collections.Generic", "MyApp.Models" } - 如果变量来自宿主程序，别直接传对象实例——改用
globals参数，定义一个class ScriptGlobals { public MyData Data; }再传进去
动态编译后怎么安全地调用方法而不是只跑表达式
CSharpScript.EvaluateAsync 只适合单表达式求值，想执行多语句、定义方法、甚至带 async 的逻辑，必须升一级：用 CSharpScript.RunAsync。
关键区别：
-
EvaluateAsync返回Task<object>，只能算一个值；RunAsync返回Task<ScriptState<object>>，能拿到作用域、导出的变量、还能调用脚本里定义的方法 - 脚本里写
void DoWork() { ... }没用，Roslyn 不会自动暴露；得用return new { DoWork = (Action)delegate { ... } };或更稳妥的：在globals类里预留委托字段，脚本里赋值 - 别忘了设置
ScriptOptions.Default.WithLanguageVersion(LanguageVersion.CSharp11)，否则 async/await 会编译失败
引用第三方 NuGet 包时为什么找不到类型
Roslyn 脚本不读取 .csproj，也不走 MSBuild，所有依赖都得显式加载。哪怕你项目里已安装 Newtonsoft.Json，脚本里写 JsonConvert.SerializeObject 也会崩。
解决路径很窄，只有两条可走：
- 用
AssemblyLoadContext.Default.LoadFromAssemblyPath手动加载 DLL 路径（注意：.NET 6+ 默认是隔离上下文，得用AssemblyLoadContext.Current或传入目标上下文） - 更推荐方式：通过
MetadataReference.CreateFromFile构造引用，再喂给ScriptOptions.WithReferences；路径可用typeof(JsonConvert).Assembly.Location动态获取，避免硬编码 - 如果包含
netstandard2.0和net6.0多目标，务必确认你加载的是当前运行时能兼容的那个版本，否则出现Could not load file or assembly 'xxx, Version=...'
脚本执行慢、首次卡顿明显怎么办
每次 RunAsync 或 EvaluateAsync 都触发完整编译流程：词法分析 → 语法树 → 绑定 → IL 生成 → JIT。这不是解释执行，是真编译，所以冷启动开销大。
提速靠预编译和复用：
- 把脚本内容哈希后缓存
Script<T>实例（不是结果！），下次直接script.RunAsync(globals)，跳过解析和编译 - 避免每次新建
ScriptOptions，复用同一个实例（它是不可变的，线程安全） - 如果脚本结构固定（比如只是换参数），改用
CSharpCompilation+Emit编译成Assembly，然后反射调用——适合高频、低变更场景，但开发成本高一截
真正难处理的是调试和异常定位：堆栈里看不到原始脚本行号，错误位置常偏移。上线前务必用 ScriptOptions.WithFilePath 绑定虚拟路径，并捕获 AggregateException 展开 InnerExceptions 才能看到真实编译错误。
