本页内容

命令行选项

要指定命令行选项,请在包含Qt Creator 可执行文件的目录中输入以下命令,或将Qt Creator 的路径作为命令的一部分指定:

qtcreator [option] [filename[:line_number[:column_number]]]

下表总结了可用的选项:

选项描述
-help显示命令行选项的帮助信息。
-version显示Qt Creator 的版本信息。
-client尝试连接到已运行的Qt Creator 实例。
-pid尝试连接到指定进程 ID 的、正在运行的Qt Creator 实例。
-block在正在运行的Qt Creator 实例中使用编辑器打开文件,并在第一个编辑器关闭之前阻塞命令行。
-no-crashcheck禁用对先前已崩溃的Qt Creator 实例的启动检查。
-load <plugin-id>启用指定的插件及其依赖的所有插件。您可以组合使用-load-noload 选项,并多次指定这两个选项来启用或禁用多个插件。这些操作将按指定顺序执行。
-load all启用所有插件。
-noload <plugin-id>禁用指定的插件及其所有依赖的插件。
-noload all禁用所有插件。
-profile输出有关插件启动和关闭的性能分析数据。
-pluginpath <path>添加Qt Creator 用于查找插件的路径。若要指定多个路径,请为每个路径添加-pluginpath 选项。
-settingspath <path>覆盖用户设置的默认存储路径。
-installsettingspath <path>覆盖读取与用户无关设置(例如安装程序写入的设置)的默认路径。
-temporarycleansettings,-tcs出于调试或测试目的,使用“干净”设置。当Qt Creator 退出时,这些设置将被删除。
-language <locale>设置用户界面语言。

请使用小写的、由两个字母组成的ISO 639 语言代码,例如deenfr

-test <plugin>[,testfunction[:testdata]] ...针对Qt Creator 插件开发者:默认使用单独的设置路径运行插件测试。
-test all对于Qt Creator 插件开发者:运行所有插件的测试。
-notest <plugin>针对Qt Creator 插件开发者:将该插件的所有测试从测试运行中排除。
-color <color>核心插件:覆盖所选的 UI 颜色。
-presentationMode核心插件:在选中键盘快捷键时,将其以弹出窗口形式显示。这在向他人演示Qt Creator 时尤为有用。
-theme <default | dark>核心插件:为Qt Creator 应用深色主题,无需使用样式表。
-notour欢迎插件:启动时跳过 UI 导览。
-debug <pid>调试器插件:附加到指定进程 ID 的进程上。
-debug <可执行文件>[,kit=<kit>]调试器插件:启动并调试名称为executable 的可执行文件。可通过 ID 或名称指定kit ,以指向非默认的调试器和系统根目录。
-debug [executable,]core=<corefile>[,kit=<kit>]调试器插件:加载名为corefile 的核心文件。参数executable 指定生成该核心文件的可执行文件。如果省略此参数,Qt Creator 将尝试根据核心文件本身重建该可执行文件。对于路径长度超过约 80 个字符的情况,此操作将失败。在这种情况下,executable 参数是必填的。 可以通过 ID 或名称指定kit ,以指向非默认的调试器和系统根目录。
-debug <可执行文件>,server=<服务器:端口>[,kit=<套件>]调试器插件:连接到在服务器server 的端口port 上运行的调试服务器。参数executable 指定远程调试服务器正在操作的可执行文件的本地副本。可以通过 ID 或名称指定kit ,以指向非默认的调试器和系统根目录。
-wincrashevent <event-handle:pid>调试器插件:使用指定的事件句柄和进程 ID 附加到已崩溃的进程。
-git-show <git commit hash>Git 插件:显示指定的提交哈希。
-customwizard-verboseProjectExplorer 插件:在加载自定义向导时显示附加信息。有关自定义向导的更多信息,请参阅“自定义向导”
-ensure-kit-for-binary <二进制文件路径>ProjectExplorer 插件:创建一个包含与给定二进制文件架构相对应的工具链的开发套件。
-lastsessionProjectExplorer 插件:在Qt Creator 启动时加载上次会话。打开上次退出Qt Creator 时已打开的项目和文件。
<会话>ProjectExplorer 插件:在Qt Creator 启动时加载指定的会话。打开上次退出Qt Creator 时已打开的项目和文件。

使用自定义样式

Qt Creator Qt application 属于 Qt XML 应用程序,因此支持所有 Qt XML 应用程序都支持的命令行选项。例如,您可以使用 和 选项来应用自定义样式和-style -stylesheet 样式表。这些样式仅在当前会话期间生效。

应用样式时请谨慎操作,因为覆盖现有样式可能会导致某些项目难以辨认。此外,设置样式表可能会影响文本编辑器的配色方案以及内置的Qt Widgets Designer的样式。

您还可以切换到深色主题,无需使用样式表即可自定义小部件、颜色和图标的外观。

另请参阅 “从命令行运行Qt Creator ”和“管理会话”。

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.