如何在LinqPad中运行CefSharp.OffScreen并解决程序集加载报错问题

问题核心原因 #

你遇到的两个报错本质是两个独立问题：

1. 文件找不到：CefSharp包含大量非托管dll和资源文件，默认只会在当前进程执行目录搜索，而LinqPad的查询执行目录是临时生成的，默认不包含CefSharp的原生依赖路径
2. BadImageFormatException：当前运行的进程架构（LinqPad的32/64位）和你引用的CefSharp dll架构不匹配

可行解决方案 #

CefSharp完全可以在VS/MSBuild之外的环境运行，按以下步骤操作即可：

步骤1：固定运行架构 #

• 打开LinqPad，进入「编辑>首选项>查询」，将「默认查询处理器架构」固定为你需要的版本，比如x64，之后重启LinqPad确保生效，全程不要切换架构。

步骤2：配置引用和路径 #

新建C# Program类型的查询，通过Nuget安装对应版本的CefSharp.OffScreen，注意版本要和你报错的版本一致（95.7.141），然后用以下代码作为查询内容：

void Main()
{
    // 替换为你本机对应版本CefSharp的native目录路径，x86就把win-x64换成win-x86
    var cefNativePath = @"C:\Users\你的用户名\.nuget\packages\cefsharp.offscreen\95.7.141\runtimes\win-x64\native";
    
    // 将原生依赖路径加入进程环境变量，解决非托管dll找不到的问题
    Environment.SetEnvironmentVariable("PATH", $"{cefNativePath};{Environment.GetEnvironmentVariable("PATH")}", EnvironmentVariableTarget.Process);

    var cefSettings = new CefSettings
    {
        // 手动指定子进程路径
        BrowserSubprocessPath = Path.Combine(cefNativePath, "CefSharp.BrowserSubprocess.exe"),
    };
    // 关闭GPU加速减少OffScreen模式的异常
    cefSettings.CefCommandLineArgs.Add("disable-gpu");

    // 全局仅可初始化一次，重跑查询前需先调用Cef.Shutdown()或重启LinqPad
    if (!Cef.IsInitialized)
    {
        // 关闭默认依赖检查，避免误报找不到文件
        Cef.Initialize(cefSettings, performDependencyCheck: false, browserProcessHandler: null);
    }

    // 测试代码可替换为你自己的逻辑
    using (var browser = new ChromiumWebBrowser("about:blank"))
    {
        browser.WaitForInitialLoadAsync().Wait(TimeSpan.FromSeconds(10));
        "初始化成功".Dump();
    }

    // 测试完成后关闭Cef实例，方便下次重跑
    Cef.Shutdown();
}

可选兜底方案 #

如果上述配置后仍有找不到文件的报错，直接将cefNativePath目录下的所有文件全选复制到LinqPad的安装目录（即LinqPad.exe所在的文件夹）即可解决。

BadImageFormatException排查 #

如果仍有格式错误的报错，逐一核对以下三项的架构必须完全一致：

• LinqPad的运行架构（步骤1中固定的x86/x64）
• 你引用的CefSharp包的架构
• 你本机Windows系统的架构

内容的提问来源于stack exchange，提问作者OrdinaryOrange