马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。
您需要 登录 才可以下载或查看，没有账号？立即注册
×
一、安装 Qt Creator
Ubuntu 下搭 Qt 环境，最省事的路子就是走官方仓库：一次更新索引、一次装编译工具、一次装 Qt Creator，然后把 Qt 5 默认版本选上，最后补文档和示例，后面做复杂项目时用得上。
先开终端（Ctrl+Alt+T）确认有 sudo 权限，Ubuntu 只有授权用户才能增删软件，装的过程中会要求输密码，提示继续时输入 Y 回车。
第一步，更新软件源索引：
sudo apt-get update
第二步，装编译必需的基础包：
sudo apt-get install build-essential
第三步，装 Qt Creator，它带上做和跑 Qt 项目需要的界面工具与命令行工具：
sudo apt-get install qtcreator
第四步，确认默认 Qt 5 已被选中：
sudo apt-get install qtbase5-dev
第五步，补文档和示例，做复杂项目时查 API 很省时间：
sudo apt-get install qt5-doc qtbase5-examples
装完搜一下就能打开 Qt Creator，也可以在终端直接敲：
qtcreator
二、验证环境能不能编译
mkdir -p ~/qt-test && cd ~/qt-test
qmake --version
能看到 Qt 版本号就说明工具链在 PATH 里。用 Qt Creator 新建项目时选 Qt Widgets Application，一路默认，编译运行能弹窗就是环境通了。
命令行也能编译，适合 CI 环境：
qmake
make
./your-app
三、常见故障
qmake: command not found —— 没装 qtbase5-dev，补 sudo apt-get install qtbase5-dev；装完当前终端找不到就 source ~/.bashrc 或重开终端。error: Qt5CoreConfig.cmake: No such file —— Qt 开发包不全，补 qtbase5-dev 和 qtbase5-dev-tools。- 编译报一大串
undefined reference to vtable —— 通常是 qmake 生成了旧的 Makefile 或者 moc 没跑，删掉构建目录重新 qmake。
- Qt Creator 能开但新建项目报错 —— 沙箱环境缺权限或 HOME 不可写，检查
~ 权限。
build-essential 装完还报 gcc 版本太低 —— Ubuntu 默认源里的 gcc 一般够 Qt 5 用；要 Qt 6 或更新工具链才考虑 LLVM/新 gcc，别盲目升系统编译器。
四、开发习惯上的几点
- 构建目录单独放，别和源码混在一起，
.gitignore 里把 build-*、.o、Makefile 排除掉。
- Qt 5 与 Qt 6 的模块划分变化很大，老项目别混装两套默认版本，容易链接错。
- 界面文件（
.ui）和逻辑分开放，Qt Designer 改布局，代码只管信号槽，后期维护轻松很多。
- 打包分发时别只发可执行文件，把
ldd 缺的动态库一起处理，或用 linuxdeploy 打 AppImage。
- 企业里做统一开发环境，建议把上面五条命令固化成脚本或配置管理模板，新人一条命令就能上手。
qidao123.com企服评测-应用市场 编辑提示
本文按 Ubuntu 官方仓库整理 Qt Creator 安装步骤与验证方法，覆盖常见编译报错和开发建议。安装前确认账号有 sudo 权限，构建目录建议与源码分离。企业统一开发环境可把依赖清单固化成脚本，Qt 5 与 Qt 6 不要混装默认版本，避免链接到不兼容的模块。
| 
发表于 2026-10-6 11:12:40