概述
qmake 工具为您提供了一个面向项目的系统,用于管理应用程序、库和其他组件的构建过程。 这种方法使您能够控制所使用的源文件,并允许简洁地描述该过程的每个步骤,通常只需一个文件即可。qmake 将每个项目文件中的信息扩展为一个 Makefile,该文件会执行编译和链接所需的命令。
描述项目
项目通过项目(.pro )文件的内容来描述。qmake 使用文件中的信息生成 Makefile,其中包含构建每个项目所需的所有命令。 项目文件通常包含源文件和头文件的列表、通用配置信息,以及任何应用程序特有的细节,例如需要链接的额外库列表,或需要使用的额外包含路径列表。
项目文件可以包含多种不同的元素,包括注释、变量声明、内置函数以及一些简单的控制结构。在大多数简单的项目中,只需声明用于构建项目的源文件和头文件,并设置一些基本的配置选项即可。 有关如何创建简单项目文件的更多信息,请参阅《qmake 入门》。
对于复杂项目,您可以创建更复杂的项目文件。有关项目文件的概述,请参阅《创建项目文件》。有关可在项目文件中使用的变量和函数的详细信息,请参阅《参考》。
您可以使用应用程序或库项目模板来指定专门的配置选项,从而对构建过程进行微调。有关更多信息,请参阅《构建常见项目类型》。
您可以使用Qt Creator 的新项目向导来创建项目文件。您选择项目模板后,Qt Creator 会生成一个包含默认值的项目文件,使您能够构建并运行该项目。您可以根据需要修改该项目文件。
您也可以使用 qmake 生成项目文件。有关 qmake 命令行选项的完整说明,请参阅《运行 qmake》。
qmake 的基本配置功能可处理大多数跨平台项目。不过,使用一些特定于平台的变量可能会很有帮助,甚至必不可少。有关更多信息,请参阅“平台注意事项”。
构建项目
对于简单的项目,您只需在项目的顶级目录中运行 qmake 即可生成 Makefile。随后,您可以运行您所在平台的make 工具,根据 Makefile 构建项目。
有关 qmake 在配置构建过程时使用的环境变量的更多信息,请参阅《配置 qmake》。
注意:请将 项目构建目录添加 到系统中任何防病毒软件的“排除目录”列表中。
添加第三方库
《使用第三方库》指南将向您展示如何在 Qt 项目中使用简单的第三方库。
预编译头文件
在大型项目中,可以利用预编译头文件来加快构建过程。有关详细信息,请参阅《使用预编译头文件》。
© 2026 The Qt Company Ltd. 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.