Selenium C# WebDriver非无头模式下无法正确设置浏览器窗口大小

核心原因 #

非无头模式下，Chrome窗口包含系统级标题栏、边框，且默认会受系统显示缩放、Chrome自身缩放设置影响。直接通过Manage().Window.Size或常规ChromeOptions参数设置的尺寸，往往是内容视口大小而非整个浏览器窗口的外框尺寸，导致实际窗口和预期出现偏差。

可行解决方案 #

1. 使用Chrome启动参数强制指定窗口尺寸并禁用缩放

通过ChromeOptions添加专属启动参数，直接控制窗口外框尺寸并排除缩放干扰：

var chromeOptions = new ChromeOptions();
// 强制缩放比例为1，避免系统/Chrome自动缩放影响尺寸
chromeOptions.AddArgument("--force-device-scale-factor=1");
// 指定窗口外框的精确尺寸（宽1366，高668）
chromeOptions.AddArgument("--window-size=1366,668");
// 禁止Chrome自动最大化窗口
chromeOptions.AddArgument("--start-maximized=false");
// 禁用可能干扰窗口尺寸的UI特性
chromeOptions.AddArgument("--disable-features=TranslateUI,AutoExpandDetailsElement");
// 禁用扩展，排除第三方扩展对窗口的影响
chromeOptions.AddArgument("--disable-extensions");

// 用配置好的Options启动Driver
var driver = new ChromeDriver(chromeOptions);

2. 结合JavaScript调整视口尺寸

如果上述参数仍未生效，可以在设置窗口大小后，通过JavaScript强制调整内容视口到目标尺寸：

// 先通过Driver设置基础窗口大小
_driverHelper.Driver.Manage().Window.Size = new System.Drawing.Size(1366, 668);
// 执行JS强制调整视口，确保内容区域精确匹配
_driverHelper.Driver.ExecuteScript(@"
    window.resizeTo(1366, 668);
    // 额外锁定视口尺寸，防止后续页面加载时自动调整
    Object.defineProperty(window, 'innerWidth', { value: 1366, writable: false });
    Object.defineProperty(window, 'innerHeight', { value: 668, writable: false });
");

3. 排除系统显示缩放干扰

如果你使用Windows系统，确保系统显示缩放设置为100%（右键桌面→显示设置→缩放与布局），或者通过Chrome参数强制忽略系统缩放（即方案1中的--force-device-scale-factor=1），这是很多尺寸偏差的常见诱因。

内容的提问来源于stack exchange，提问作者Ričards Mauriņš