在 Linux 系统中使用 ChromeDriver 启用 --headless=new 模式时，通过 window-size= 参数设置浏览器窗口尺寸无效，截图默认为 800×600；本文提供可靠替代方案并详解最佳实践。
在 linux 系统中使用 chromedriver 启用 `--headless=new` 模式时，通过 `window-size=` 参数设置浏览器窗口尺寸无效，截图默认为 800×600；本文提供可靠替代方案并详解最佳实践。
当使用 Selenium + ChromeDriver 在 Linux 环境下运行无头（--headless=new）自动化测试时，许多开发者发现传统方式——如 options.addArguments("window-size=1600,1200")——完全失效：浏览器实际渲染尺寸仍为默认的 800×600，导致元素定位偏移、截图裁剪异常或响应式 UI 测试失真。
根本原因在于：Chrome 的 --headless=new 模式（自 Chrome 109 起推荐）不再支持 window-size 启动参数。该参数仅对传统 --headless（旧版）生效，而新版 headless 实际以“虚拟视口（virtual viewport）”方式运行，启动参数无法直接控制其渲染尺寸。
✅ 正确且跨平台兼容的解决方案是：在 WebDriver 初始化后，通过 manage().window().setSize() 动态设置窗口尺寸：
ChromeOptions options = new ChromeOptions();
options.addArguments("--headless=new");
options.addArguments("--no-sandbox");
options.addArguments("--disable-dev-shm-usage");
WebDriver driver = new ChromeDriver(options);
// ✅ 关键：在 driver 实例创建后立即设置尺寸
driver.manage().window().setSize(new Dimension(1600, 1200));
⚠️ 注意事项：
- 此方法仅在
--headless=new下有效（旧版--headless不支持setSize()，会抛出UnsupportedOperationException）； - 必须在
driver.get(...)之前调用setSize()，否则部分浏览器可能忽略变更； - 若需精确控制视口（viewport）而非窗口（window），可额外添加 CSS 媒体查询适配，或结合
--force-device-scale-factor=1避免缩放干扰； - Linux 环境下建议始终启用
--no-sandbox和--disable-dev-shm-usage，防止权限与共享内存问题。
? 进阶提示：对于需要固定设备模拟（如 iPhone、iPad）的场景，推荐使用 --user-agent + --window-size（旧 headless）组合，或更可靠的 setViewport()（若使用 Playwright）；但在 Selenium 中，setSize() 是当前 --headless=new 下最稳定、最广泛验证的尺寸控制方式。
总结：摒弃已失效的启动参数，拥抱运行时动态配置——driver.manage().window().setSize() 不仅解决尺寸问题，也体现了 Selenium 对现代无头浏览器架构的适配逻辑。
