QT学习总结之UIC工具介绍

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

一、使用说明

在Qt开发里，uic（User Interface Compiler）是一个重要工具，它能够把 .ui 文件转换成 .h 头文件。要实现这一转换，可使用如下命令：

uic your_ui_file.ui -o output_header.h

下面对该命令的各部分进行说明：

• uic：这是命令的执行主体，即Qt用户界面编译器。
• your_ui_file.ui：此为需要编译的UI文件，你要把它替换成你实际使用的UI文件名称。
• -o：它的作用是指定输出文件，是一个可选参数。
• output_header.h：这是生成的头文件，你可以根据自己的需求来命名。

举个例子，若有一个名为 mainwindow.ui 的UI文件，想把它编译成 ui_mainwindow.h 头文件，就可以使用这样的命令：

uic mainwindow.ui -o ui_mainwindow.h

在Qt项目里，一般是通过qmake或者CMake来自动调用 uic 命令，这样就不用手动去执行了。不过，在进行一些调试工作或者创建独立的UI组件时，手动执行这个命令就很有必要了。

二、使用注意点

执行 uic your_ui_file.ui -o output_header.h 命令时，不一定要在 uic 所在的文件夹启动终端，但需要保证系统能够找到 uic 命令。下面为你详细介绍相关情况：

1. PATH 环境变量已配置（推荐做法）

要是你已经把Qt的工具目录添加到了系统的 PATH 环境变量中，那么在任何目录下都能直接运行 uic 命令。

示例（以Linux/macOS为例）：

# 假设Qt安装在 /opt/Qt/6.5.0/gcc_64/bin
export PATH=$PATH:/opt/Qt/6.5.0/gcc_64/bin

# 之后在任意目录下都能执行uic命令
uic mainwindow.ui -o ui_mainwindow.h

Windows系统的配置方式：
你可以通过系统属性 -> 高级系统设置 -> 环境变量，把Qt的 bin 目录添加到 PATH 中。

2. 未配置 PATH 环境变量

若 PATH 中没有包含 uic 所在的路径，那就需要使用绝对路径或者相对路径来调用 uic。

示例（以Windows为例）：

# 使用绝对路径调用uic
C:\Qt\6.5.0\msvc2019_64\bin\uic.exe mainwindow.ui -o ui_mainwindow.h

# 或者使用相对路径（假设当前目录是Qt的bin目录的上级目录）
.\bin\uic.exe mainwindow.ui -o ui_mainwindow.h

3. UI文件的路径问题

uic 命令会依据当前的工作目录来查找UI文件。所以，你可以使用绝对路径或者相对路径来指定UI文件。

示例：

# 当前工作目录是UI文件所在目录
uic mainwindow.ui -o ui_mainwindow.h

# 当前工作目录是项目根目录
uic ui/mainwindow.ui -o include/ui_mainwindow.h

4. 推荐的使用习惯

• 配置 PATH 环境变量：这样能让命令的使用更加便捷，在任何目录下都可以直接调用 uic。
• 使用相对路径：在构建系统（像CMake、qmake）中，一般会采用相对路径的方式来处理UI文件。

示例（CMake项目）：

# CMakeLists.txt
set(CMAKE_AUTOUIC ON)  # 自动处理UI文件
add_executable(myapp main.cpp mainwindow.cpp)

总结

执行 uic 命令时，不强制要求在 uic 所在的目录启动终端，关键是要保证系统能够找到 uic 命令。你可以通过配置 PATH 环境变量，或者使用绝对路径/相对路径来调用 uic。

三、uic工具路径

QT安装目录下好几个目录都有uic工具，如

# Windows下QT目录uic工具路径
C:\Qt\Qt5.12.1\5.12.1\mingw73_64\bin
C:\Qt\Qt5.12.1\5.12.1\msvc2017_64\bin

# Linux下QT目录uic工具路径
Qt5.12.1\5.12.1\gcc_64\bin

---