Qt Creator 使用指南 – wiki基地

作者： /

Qt Creator 使用指南：从入门到精通

Qt Creator 是一个功能强大、跨平台的集成开发环境（IDE），专为 Qt 框架的开发而设计，但同时也支持标准的 C++ 项目以及 QML、Web 等多种开发。它集成了代码编辑器、UI 设计器、调试器、构建工具、版本控制系统等一系列必要的工具，极大地提高了开发效率。无论是开发桌面应用、移动应用、嵌入式系统还是 WebAssembly 应用，Qt Creator 都是 Qt 开发者的首选利器。

本文将带你详细探索 Qt Creator 的各项功能和使用方法，帮助你快速上手并深入掌握这个优秀的开发环境。

第一章：初识 Qt Creator

1.1 什么是 Qt Creator？

Qt Creator 是一个跨平台的 IDE，由 Qt 公司开发和维护。它与 Qt 框架紧密集成，提供了图形化界面设计、代码编辑、项目管理、构建、调试等一站式服务。它的核心优势在于：

  • 跨平台性： 可以在 Windows、macOS、Linux 等多种操作系统上运行。
  • 集成度高： 将 Qt Designer (UI 设计器)、调试器、文档浏览器等工具无缝集成。
  • 专注于 Qt： 对 Qt 的 C++ 扩展、QML 语言、信号槽机制等有深度支持。
  • 效率高： 提供丰富的代码辅助功能、强大的调试能力和快速的构建系统。

1.2 安装与启动

安装 Qt Creator 通常是随着 Qt 安装包一起进行的。你可以从 Qt 官方网站下载在线安装器，根据向导选择需要安装的 Qt 版本、构建工具（如 MinGW、MSVC、GCC/Clang）、调试器以及 Qt Creator 本身。

安装完成后，启动 Qt Creator。你会看到一个欢迎界面。

第二章：Qt Creator 用户界面概览

Qt Creator 的界面布局清晰，主要分为以下几个区域：

2.1 模式选择器 (Mode Selector)

位于窗口左侧，一列按钮，用于在不同的工作模式之间切换。这是 Qt Creator 的核心导航方式。常见的模式包括：

  • 欢迎 (Welcome)： 显示项目列表、新闻、教程、Qt examples 等。通常是启动后看到的第一个界面。
  • 编辑 (Edit)： 代码编辑器模式，用于编写、修改代码文件（C++, QML, .pro, CMakeLists.txt 等）。这是最常用的模式。
  • 设计 (Design)： 用于编辑 .ui (Qt Widgets) 或 .qml 文件。集成了 Qt Designer 和 QML Designer。
  • 调试 (Debug)： 调试程序时进入的模式，显示堆栈、变量、寄存器、调试日志等信息。
  • 项目 (Projects)： 配置和管理项目的构建、运行、部署设置。
  • 分析 (Analyze)： 用于代码静态分析（如 Clang-Tidy, Cppcheck）和性能分析（如 Valgrind）。
  • 测试 (Test)： 运行单元测试（如 Qt Test）。
  • 部署 (Deploy)： 配置和执行应用程序的部署任务。
  • 帮助 (Help)： 集成 Qt 官方文档，可以通过关键词搜索或浏览文档。
  • 市场 (Marketplace)： 浏览和安装 Qt Creator 插件。

2.2 侧边栏 (Sidebar)

位于模式选择器旁边，根据当前选择的模式显示不同的视图或导航工具。例如，在编辑模式下显示项目文件结构，在调试模式下显示变量列表，在帮助模式下显示文档目录。

2.3 编辑/设计区域 (Editor/Designer Area)

位于窗口中央，是主要的工作区域。在编辑模式下是代码编辑器，在设计模式下是 UI 设计器。支持多分栏显示文件。

2.4 输出窗格 (Output Pane)

位于窗口底部，用于显示构建输出、编译错误、应用程序输出、调试器日志、版本控制信息等。这个区域非常重要，可以帮助你了解项目状态和查找问题。常见的标签页包括：

  • 编译输出 (Compile Output)： 显示构建命令和编译器/链接器的输出。
  • 应用程序输出 (Application Output)： 显示程序运行时通过 qDebug(), qInfo(), std::cout 等输出的信息。
  • 调试日志 (Debugger Log)： 显示调试器（如 GDB, CDB, LLDB）的通信日志。
  • 问题 (Issues)： 汇总编译错误、警告、代码分析问题等。双击条目可以直接跳转到源代码位置。
  • 版本控制 (Version Control)： 显示 Git 等版本控制系统的操作日志。
  • 搜索结果 (Search Results)： 显示文件搜索结果。

2.5 状态栏 (Status Bar)

位于窗口底部，显示当前文件的编码、行号列号、编辑器模式（插入/覆盖）、Vim 模式状态、Git 分支信息等。

第三章：项目管理

Qt Creator 的核心是项目。所有的开发活动都围绕项目进行。

3.1 创建新项目

点击欢迎模式下的 “新建项目” 或菜单栏的 “文件” -> “新建文件或项目”。你会看到一个向导，指导你创建不同类型的项目：

  • Application (应用):
    • Qt Widgets Application: 创建基于 QWidgets 的传统桌面 GUI 应用。这是最常见的类型之一。
    • Qt Quick Application (QML): 创建基于 QML 的现代、流畅界面应用。
    • Console Application: 创建非 GUI 的控制台应用。
    • 其他类型（如嵌入式应用、Qt for WebAssembly 应用等）。
  • Library (库): 创建共享库或静态库。
  • Non-Qt Project (非 Qt 项目): 可以创建纯 C++ 项目、基于 CMake 的项目等。
  • Other Projects (其他项目): 包括导入现有项目等。

选择项目类型后，向导会让你填写项目名称、路径，选择构建系统（通常是 qmake 或 CMake），选择套件 (Kit)，设置类信息等。

  • 构建系统 (Build System):
    • qmake: Qt 自带的构建系统，使用 .pro 文件描述项目。简单易用，适合大多数 Qt 项目。
    • CMake: 另一种流行的跨平台构建系统，使用 CMakeLists.txt 文件。更灵活，适合大型或依赖复杂的项目。
  • 套件 (Kit): 套件是 Qt Creator 中一个非常重要的概念，它代表了一套完整的开发环境配置，包括：
    • 一个特定的 Qt 版本。
    • 一个构建工具链（编译器、链接器）。
    • 一个调试器。
    • 一个设备（桌面、Android、iOS、嵌入式板卡等）。
    • 其他相关设置。

你需要为你的项目选择一个或多个合适的套件，这样 Qt Creator 才知道如何编译、运行你的项目。

3.2 打开现有项目

点击欢迎模式下的 “打开项目” 或 “文件” -> “打开文件或项目”。选择项目的构建文件 (.pro for qmake, CMakeLists.txt for CMake)。Qt Creator 会加载项目并显示在项目侧边栏。

3.3 项目文件结构

在项目模式或编辑模式的侧边栏中，你可以看到项目的逻辑结构或文件系统结构。

  • Logical View: 按照项目类型（如源文件、头文件、界面文件、资源文件）组织文件，更直观。
  • File System View: 显示项目文件夹的实际文件结构。

你可以通过右键菜单在项目中添加新的文件（C++ 类、Qt 类、QML 文件、UI 文件等），删除文件，重命名文件等。

3.4 项目配置 (项目模式)

切换到 项目 (Projects) 模式，你可以详细配置项目的构建、运行、部署设置。

  • 构建设置 (Build Settings):
    • 选择套件。
    • 选择构建配置 (Debug/Release/Profile)。
    • 配置构建步骤（如 qmake/cmake 执行命令、make 参数）。
    • 配置构建目录、阴影构建 (Shadow Build，将构建输出放在单独的目录，保持源代码目录干净)。
    • 配置构建环境。
  • 运行设置 (Run Settings):
    • 选择运行的可执行文件。
    • 设置工作目录。
    • 设置命令行参数。
    • 设置运行环境。
    • 配置调试器（选择调试后端）。
  • 部署设置 (Deploy Settings): 配置将可执行文件和依赖项复制到目标设备或目录。

你可以在这里为不同的套件配置不同的构建和运行设置。

第四章：代码编辑

编辑模式是 Qt Creator 最常用的模式。它提供了一个功能丰富的代码编辑器。

4.1 基本编辑功能

  • 语法高亮： 根据不同的语言（C++, QML, Python, XML 等）高亮关键词、注释、字符串等，提高代码可读性。
  • 代码折叠： 可以折叠函数、类、代码块等，隐藏不关心的代码。
  • 括号匹配： 高亮显示匹配的括号，方便检查代码结构。
  • 自动缩进： 粘贴或输入代码时自动调整缩进。
  • 智能感知 (Intellisense / Code Completion)： 输入代码时，Qt Creator 会根据上下文提示可能的类、对象、函数、变量、枚举等，大大提高输入速度并减少错误。这对于 Qt 框架特别有用，它可以智能提示 Qt 类的成员函数、信号、槽等。
  • 代码片段 (Snippets)： 预定义或自定义的代码模板，输入缩写后按 Tab 键即可生成一段完整的代码（如 class for class definition, fori for for loop）。
  • 文件编码和换行符设置： 可以在状态栏或编辑器设置中调整。

4.2 代码导航

  • 转到定义/声明 (Go to Definition/Declaration): 按 F2 或右键菜单选择此项，可以快速跳转到函数、变量、类等的定义或声明位置。配合 Ctrl + Click (或 Cmd + Click) 使用更方便。
  • 查找用法 (Find Usages): 右键选择此项，查找当前符号在项目中的所有使用位置。结果显示在搜索结果窗格。
  • 定位器 (Locator): 按 Ctrl + K (或 Cmd + K) 弹出搜索框。可以快速搜索文件、类、函数、书签、运行菜单项等。输入前缀（如 f for files, c for classes, m for methods, b for bookmarks）可以缩小搜索范围。例如，输入 f main.cpp 可以快速打开 main.cpp 文件。
  • 书签 (Bookmarks): 按 Ctrl + M (或 Cmd + M) 在当前行设置书签。按 Ctrl + B (或 Cmd + B) 显示所有书签并在书签之间跳转。
  • 最近文件和编辑位置： 通过菜单或快捷键快速切换到最近打开的文件或最近编辑过的位置。

4.3 代码重构

  • 重命名 (Rename): 右键选择此项，可以安全地重命名变量、函数、类等，Qt Creator 会同时修改所有使用到该符号的地方。
  • 提取函数/变量： 将一段代码提取为一个新的函数或变量。

4.4 静态分析和格式化

  • 集成静态分析工具： 可以配置并运行 Clang-Tidy、Cppcheck 等工具，在编辑器中显示潜在的代码问题（错误、警告、风格建议）。
  • 代码格式化： 集成 ClangFormat 或 AStyle。可以配置格式化风格，然后通过菜单或快捷键格式化当前文件或选中的代码块。

4.5 处理不同文件类型

  • .cpp / .h: C++ 代码文件。提供丰富的 C++ 编辑功能。
  • .ui: Qt Widgets 界面文件。双击会在设计模式中打开 Qt Designer。
  • .qml: QML 界面文件。双击会在设计模式中打开 QML Designer。
  • .qrc: Qt 资源文件。可以在编辑模式中编辑，或者通过右键菜单使用资源编辑器。
  • .pro: qmake 项目文件。有语法高亮和基本的自动完成。
  • CMakeLists.txt: CMake 项目文件。有语法高亮和基本的自动完成。

第五章：UI 设计 (设计模式)

设计模式集成了 Qt Designer (用于 .ui 文件) 和 QML Designer (用于 .qml 文件)。

5.1 Qt Designer (.ui 文件)

打开一个 .ui 文件会自动进入设计模式并启动 Qt Designer。

  • 部件箱 (Widget Box): 位于左侧，列出所有可用的 QWidgets 部件，可以通过拖拽添加到窗体上。
  • 窗体编辑区域 (Form Editor): 位于中央，可视化显示窗体布局，可以直接在上面放置、调整部件。
  • 对象查看器 (Object Inspector): 位于右侧上方，显示窗体上所有部件的层级结构。
  • 属性编辑器 (Property Editor): 位于右侧下方，显示当前选中部件的所有属性及其值，可以直接修改。
  • 信号槽编辑器 (Signals & Slots Editor): 在窗体编辑区域下方或通过菜单打开，用于可视化连接信号和槽。这是 Qt 强大的特性之一。
  • 布局 (Layouts): 使用布局管理器 (如水平布局 HBoxLayout, 垂直布局 VBoxLayout, 网格布局 GridLayout) 是构建自适应界面的关键。将部件放到布局中，它们会根据窗体大小自动调整位置和大小。

5.2 QML Designer (.qml 文件)

打开一个 .qml 文件会自动进入设计模式并启动 QML Designer。它提供了一个可视化的编辑区域，可以拖拽 QML Items，编辑属性，查看组件树，并实时预览 QML 界面。

第六章：构建与运行

完成代码编写和界面设计后，就需要构建和运行程序。

6.1 构建项目

  • 选择构建配置： 在左下角（通常是绿色运行按钮旁边）的下拉菜单中选择 Debug 或 Release 配置。Debug 配置包含调试信息，方便调试，但体积较大，运行较慢。Release 配置经过优化，体积小，运行快，但不包含调试信息。
  • 构建： 可以通过菜单 “构建” -> “构建项目 [项目名称]” 或使用快捷键 Ctrl + B (或 Cmd + B) 来启动构建。
  • 查看构建输出： 构建过程的详细输出会显示在底部输出窗格的 “编译输出” 标签页。如果构建失败，错误和警告会显示在 “问题” 标签页。双击问题条目可以直接跳转到出错的代码行。

6.2 运行项目

  • 运行： 点击左下角的绿色运行按钮，或通过菜单 “构建” -> “运行” (快捷键 Ctrl + R 或 Cmd + R)。
  • 查看应用程序输出： 程序运行时的标准输出和标准错误会显示在底部输出窗格的 “应用程序输出” 标签页。
  • 运行配置： 在项目模式的 “运行设置” 中，可以配置程序的运行参数、工作目录、环境变量等。

第七章：调试程序

当程序出现问题时，调试是定位和解决问题的关键。Qt Creator 提供了强大的集成调试器。

7.1 进入调试模式

  • 启动调试： 点击左下角的绿色带有 bug 图标的运行按钮，或通过菜单 “构建” -> “开始调试” (快捷键 F5)。
  • 设置断点： 在代码编辑器的行号区域点击，或者将光标放在某一行按 F9，即可在该行设置断点。程序运行到断点处会自动暂停。断点可以是条件的（仅当某个条件满足时才暂停）。

7.2 调试操作

程序在断点处暂停后，可以进行以下操作：

  • 继续 (Continue): F5 或绿色箭头按钮。程序继续执行直到下一个断点或程序结束。
  • 步过 (Step Over): F10 或蓝色箭头按钮。执行当前行代码，如果当前行是函数调用，则不进入函数内部，直接执行完函数后暂停在下一行。
  • 步入 (Step Into): F11 或蓝色箭头+向下箭头按钮。执行当前行代码，如果当前行是函数调用，则进入函数内部，暂停在函数的第一行可执行代码处。
  • 步出 (Step Out): Shift + F11 或蓝色箭头+向上箭头按钮。执行完当前函数剩余的代码，然后暂停在调用当前函数的那一行的下一行。
  • 运行到光标处 (Run to Cursor): F4 或右键菜单。程序继续执行直到光标所在的行。
  • 停止调试 (Stop Debugging): Shift + F5 或红色停止按钮。终止正在调试的程序。

7.3 调试信息窗格 (调试模式)

进入调试模式后，Qt Creator 的界面会切换到调试模式布局，底部和侧边栏会显示多个调试相关的窗格：

  • 堆栈 (Stack): 显示当前的函数调用堆栈，可以看到程序是如何到达当前暂停位置的函数调用序列。
  • 局部变量和表达式 (Locals and Expressions): 显示当前作用域内的局部变量及其值。你也可以在这里添加自定义的表达式 (Watch) 来查看任意变量或表达式的值。
  • 线程 (Threads): 如果程序是多线程的，这里会列出所有线程，并可以切换到不同的线程查看其堆栈和变量。
  • 模块 (Modules): 列出程序加载的所有动态库/模块。
  • 调试器日志 (Debugger Log): 显示调试器（如 GDB, CDB）与 Qt Creator 之间的通信日志。
  • 应用程序输出 (Application Output): 同运行模式下的输出。

7.4 查看变量值

  • 鼠标悬停： 在代码中将鼠标悬停在变量名上，通常会弹出一个小窗口显示变量的当前值。
  • 局部变量和表达式窗格： 在此窗格中直接查看或添加变量/表达式。可以展开查看复杂对象的成员。

第八章：帮助与文档

Qt Creator 集成了 Qt 官方文档，这是学习和使用 Qt 的宝贵资源。

  • 帮助模式： 切换到帮助模式，可以浏览完整的 Qt 文档目录，使用索引或强大的搜索功能查找特定类、函数、概念的文档。
  • 上下文敏感帮助： 在代码编辑器中，将光标放在任何 Qt 类名、函数名、宏等上面，按 F1 键，Qt Creator 会自动在帮助模式中打开对应的文档页面。这是获取帮助最快的方式。

第九章：版本控制集成

Qt Creator 内置了对常见版本控制系统（如 Git, Mercurial, Subversion）的支持。Git 是目前最常用的。

  • 配置版本控制： 在 “工具” -> “选项” -> “版本控制” 中配置版本控制工具的路径。
  • 集成到项目： 对于基于 Git 的项目，Qt Creator 会自动检测 .git 目录。
  • 版本控制侧边栏/窗格： 在编辑模式下，侧边栏通常有版本控制视图，显示文件的状态（已修改、已暂存、未跟踪等）。底部输出窗格有版本控制日志。
  • 常用操作： 可以通过右键菜单或菜单栏执行常见的 Git 操作：
    • 提交 (Commit)
    • 推送 (Push) / 拉取 (Pull)
    • 克隆 (Clone)
    • 分支管理 (Branches)
    • 暂存/取消暂存 (Stage/Unstage)
    • 查看文件差异 (Diff)
    • 查看提交历史 (Log)

第十章：其他实用功能和技巧

  • 快捷键： 熟练使用快捷键可以极大提高效率。可以在 “工具” -> “选项” -> “环境” -> “键盘” 中查看和自定义快捷键。
  • Locator (Ctrl+K)： 再强调一次，Locator 是一个非常强大的导航工具，不仅可以找文件代码，还可以快速运行菜单命令。
  • 主题和外观： 在 “工具” -> “选项” -> “环境” -> “界面样式” 中可以修改 Qt Creator 的主题和字体。
  • 插件： Qt Creator 支持插件扩展功能。可以在 “帮助” -> “关于插件” 中管理已安装插件，或在市场模式中浏览和安装新插件。
  • ToDo 注释： 在代码中使用 // TODO: 或 // FIXME: 等标记，Qt Creator 会在 “问题” 窗格中列出这些待办事项。
  • 代码片段 (Snippets)： 在 “工具” -> “选项” -> “文本编辑器” -> “片段” 中可以管理和创建自己的代码片段。
  • 宏录制与回放： 在编辑模式下，可以录制一系列编辑操作并保存为宏，然后回放，用于重复性的编辑任务。

总结

Qt Creator 是一个为 Qt 开发量身打造的优秀 IDE。通过本文的详细介绍，你应该对它的主要功能和使用流程有了全面的了解。从项目创建、代码编写、界面设计，到构建、运行、调试，再到文档查阅和版本控制，Qt Creator 提供了一个集成且高效的工作环境。

掌握 Qt Creator 的各种模式、窗格和快捷键，并善用其提供的代码辅助、导航、调试工具，将使你的 Qt 开发事半功倍。最重要的是，多动手实践，尝试使用本文中提到的各项功能，不断探索其更高级的用途。

祝你在 Qt 开发的旅程中一切顺利！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部