浏览器(如 Google Chrome、Microsoft Edge、Brave、Chromium 等)都基于 Chromium 内核,因此它们支持一套共同的命令行启动参数。以下是 常见 Chromium 浏览器启动参数 的详细说明(包括含义):
🧭 常用启动参数列表及说明
| 参数 | 含义 |
|---|---|
--incognito |
启动无痕模式(隐身窗口)。 |
--start-maximized |
启动时窗口最大化。 |
--new-window |
强制以新窗口打开 URL。 |
--app=<URL> |
以“应用模式”打开指定网址(无地址栏/标签页)。 |
--user-data-dir=<路径> |
指定用户数据目录(可用于隔离用户配置)。 |
--profile-directory="<名称>" |
指定加载的用户配置目录(如“Profile 1”)。 |
--no-first-run |
跳过首次运行设置。 |
--disable-extensions |
禁用所有扩展程序。 |
--disable-popup-blocking |
关闭弹窗拦截。 |
--disable-infobars |
禁用“Chrome 正在被自动测试控制”的提示条(已废弃)。 |
--disable-gpu |
禁用 GPU 加速(可解决部分图形问题)。 |
--headless |
无头模式,不显示 GUI(常用于自动化测试)。 |
--remote-debugging-port=<端口> |
开启远程调试端口,例如用于 Puppeteer。 |
--window-size=宽x高 |
设置窗口初始大小,如 --window-size=1280,720。 |
--kiosk |
启动为“展台模式”,全屏、无边框。 |
--force-device-scale-factor=<比例> |
缩放比例(如 2 表示 200% 缩放)。 |
--disable-features=<功能列表> |
禁用指定的实验性功能。 |
--enable-features=<功能列表> |
启用指定的实验性功能。 |
--no-sandbox |
禁用安全沙盒(⚠️ 不建议用于正式环境)。 |
--disable-web-security |
禁用同源策略(开发调试用,⚠️ 安全风险极高)。 |
--lang=<语言> |
设置界面语言(如 --lang=zh-CN)。 |
--proxy-server=<代理地址> |
设置代理服务器,如 --proxy-server=127.0.0.1:8888。 |
--ignore-certificate-errors |
忽略 SSL 证书错误。 |
--allow-file-access-from-files |
允许文件访问本地文件(用于 file:// 访问 file://)。 |
--disable-dev-shm-usage |
在 Docker 中运行时避免 /dev/shm 空间不足的问题。 |
--print-to-pdf=<路径> |
以 PDF 格式打印页面,保存到指定路径(与 --headless 一起用)。 |
🧪 开发与调试相关参数
| 参数 | 含义 |
|---|---|
--enable-logging |
启用日志记录,配合 --v=<级别> 查看详细日志。 |
--v=<日志级别> |
设置日志级别,0 为最少,最大为 99。 |
--js-flags="--expose-gc" |
启用 V8 的垃圾回收函数(window.gc())。 |
--enable-blink-features=<特性> |
启用 Blink 引擎实验功能。 |
--no-proxy-server |
禁用代理设置。 |
📦 示例
chrome.exe --incognito --disable-extensions --remote-debugging-port=9222
含义:打开无痕窗口、禁用扩展、开启调试端口。
chrome.exe --app="https://chat.openai.com" --user-data-dir="D:\CustomChromeData"
含义:以“App 模式”打开 ChatGPT,并使用自定义用户数据目录。
📘 如何查看完整参数
可以通过以下方式查看完整命令行参数(包括隐藏参数):
-
Chromium 文档(源码):
<ul> <li> <p><a data-link-icon="https://csdnimg.cn/release/blog_editor_html/release2.3.9/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=P4F5" data-link-title="List of Chromium Command Line Switches « Peter Beverloo" href="https://peter.sh/experiments/chromium-command-line-switches/" title="List of Chromium Command Line Switches « Peter Beverloo">List of Chromium Command Line Switches « Peter Beverloo</a></p> </li> <li> <p><a data-link-icon="https://csdnimg.cn/release/blog_editor_html/release2.3.9/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=P4F5" data-link-title="https://cs.chromium.org" href="https://cs.chromium.org/" title="https://cs.chromium.org">https://cs.chromium.org</a> 搜索 <code>command_line.cc</code></p> </li> </ul> </li> <li> <p><strong>本地查看</strong>:</p> <pre>chrome.exe --help
如果你有特定的使用场景(例如 Puppeteer 自动化、无头截图、调试 WebView2 等),我也可以提供定制参数建议。需要吗?