Selenium结合Sikuli4Net无法对比ChromeDriver启动的全屏/窗口图像

我之前也碰到过类似的全屏图像对比问题，结合Selenium和Sikuli4Net的时候确实容易踩几个坑，给你几个排查和解决的方向：

1. 先确保Chrome是真正的全屏模式（而非窗口最大化） #

很多人会用driver.Manage().Window.Maximize()，但这只是窗口最大化，不是系统级的全屏（比如按F11后的状态），两者的显示范围和像素布局有差异，会直接影响对比结果。

你可以通过ChromeOptions启动时直接全屏，或者启动后用JavaScript切换：

// 方式1：启动Chrome时直接进入全屏
ChromeOptions options = new ChromeOptions();
options.AddArgument("--start-fullscreen");
webdriver = new ChromeDriver(options);

// 方式2：启动后用JS切换到全屏（适合需要先做其他操作再全屏的场景）
IJavaScriptExecutor js = (IJavaScriptExecutor)webdriver;
js.ExecuteScript("document.documentElement.requestFullscreen();");

2. 针对Chrome窗口而非整个屏幕做对比 #

Sikuli的Screen类默认捕获整个屏幕，如果你的测试环境有其他窗口干扰（比如任务栏、弹窗），会导致对比失败。建议定位到Chrome窗口的区域，只在这个范围内对比：

首先需要借助Windows API获取Chrome窗口的坐标和尺寸，再创建Sikuli的Region对象：

// 引入Windows API用于获取窗口信息
[DllImport("user32.dll")]
private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);

[StructLayout(LayoutKind.Sequential)]
public struct RECT
{
    public int Left;
    public int Top;
    public int Right;
    public int Bottom;
}

// 在测试方法中获取Chrome窗口区域
string windowHandle = webdriver.CurrentWindowHandle;
IntPtr hWnd = new IntPtr(long.Parse(windowHandle));
RECT rect;
GetWindowRect(hWnd, out rect);
int width = rect.Right - rect.Left;
int height = rect.Bottom - rect.Top;

// 创建对应Chrome窗口的Region对象
Region chromeWindowRegion = new Region(rect.Left, rect.Top, width, height);

之后所有的图像对比操作都基于这个chromeWindowRegion，而不是默认的Screen，就能避免其他屏幕内容的干扰。

3. 保证截图与测试窗口的分辨率一致 #

如果你的截图是在不同分辨率环境下捕获的，哪怕是轻微的分辨率差异，都会让Sikuli的匹配率骤降。可以固定Chrome的窗口分辨率，确保和截图环境一致：

ChromeOptions options = new ChromeOptions();
options.AddArgument("--window-size=1920,1080"); // 设置和截图一致的分辨率
options.AddArgument("--start-fullscreen");
webdriver = new ChromeDriver(options);

4. 调整Sikuli的匹配阈值 #

Sikuli默认的匹配阈值较高，轻微的像素差异（比如加载动画残留、字体渲染差异）都会判定不匹配。可以通过Similar方法降低阈值，适配实际测试场景：

// 设置80%的匹配度即可（可根据实际情况调整0-1之间的数值）
Pattern googleSearchPattern = new Pattern(@"C:\Path\To\Your\Screenshot.png").Similar(0.8f);

修改后的完整测试代码示例 #

[TestClass]
public class UnitTest1
{
    private IWebDriver webdriver = null;
    private APILauncher launcher = new APILauncher(true);

    [DllImport("user32.dll")]
    private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);

    [StructLayout(LayoutKind.Sequential)]
    public struct RECT
    {
        public int Left;
        public int Top;
        public int Right;
        public int Bottom;
    }

    [TestMethod]
    public void TestMethod1()
    {
        launcher.Start();
        
        // 配置Chrome，固定分辨率+全屏
        ChromeOptions options = new ChromeOptions();
        options.AddArgument("--window-size=1920,1080");
        options.AddArgument("--start-fullscreen");
        webdriver = new ChromeDriver(options);
        
        webdriver.Navigate().GoToUrl("http://www.google.com");

        // 获取Chrome窗口的Region
        string windowHandle = webdriver.CurrentWindowHandle;
        IntPtr hWnd = new IntPtr(long.Parse(windowHandle));
        RECT rect;
        GetWindowRect(hWnd, out rect);
        int width = rect.Right - rect.Left;
        int height = rect.Bottom - rect.Top;
        Region chromeWindowRegion = new Region(rect.Left, rect.Top, width, height);

        // 加载截图并设置匹配阈值
        Pattern googleSearchScreenPattern = new Pattern(@"C:\Your\Screenshot\Path.png").Similar(0.8f);
        
        // 执行图像对比
        Match match = chromeWindowRegion.Find(googleSearchScreenPattern);
        Assert.IsNotNull(match, "全屏图像对比失败，未找到匹配区域");
        
        // 清理资源
        webdriver.Quit();
        launcher.Stop();
    }
}

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