萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Ubuntu 建立 Qt 開發環境完整指南:Qt 4/5/6、Qt Creator、Qwt、MySQL 驅動一鍵部署

現代 Ubuntu (20.04/22.04/24.04) 一鍵安裝


# Qt 6 (LTS 推薦)
sudo apt update
sudo apt install qt6-base-dev qt6-tools qt6-declarative-dev qt6-charts-dev \
                 qtcreator cmake g++ libgl1-mesa-dev

# Qt 5 (舊專案維護)
sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools \
                 qtdeclarative5-dev qtcreator cmake g++

# Qt 4 (極舊專案,Ubuntu 20.04 後已移除官方源,需 PPA 或源碼編譯)

核心套件說明

套件用途
qt6-base-devQt 核心庫、頭文件、qmake、moc、rcc、uic
qt6-toolsQt Designer、Qt Linguist、Qt Assistant、qdbus
qtcreator官方 IDE,整合編輯、編譯、除錯、版控、Analyzer
cmake現代 Qt 專案標準建構系統
g++C++ 編譯器

MySQL/MariaDB 資料庫驅動


# Qt 6
sudo apt install libqt6sql6-mysql

# Qt 5
sudo apt install libqt5sql5-mysql

# 驗證驅動可用
# Qt Creator → Tools → Options → Analyzer → Plugins → Qt SQL Drivers → QMYSQL 應顯示可用

Qwt 繪圖庫(科學繪圖、波形圖、儀表板)


# Ubuntu 20.04+
sudo apt install libqwt-qt6-dev qwt6-doc  # Qt 6
# 或
sudo apt install libqwt-qt5-dev qwt5-doc  # Qt 5

# 安裝後 Qt Designer 左側元件面板會出現 "Qwt Widgets" 群組

推薦 IDE:Qt Creator 進階配置

  1. Kit 管理: Tools → Options → Kits → 確認 Qt Version、Compiler、Debugger (GDB)、CMake 自動偵測正確
  2. 程式碼風格: 採用 Qt 官方風格(縮排 4、大括號新行)
  3. Clangd / Cppcheck 整合: 安裝 clangd、cppcheck,啟用 LSP 即時靜態分析
  4. FakeVim 模式: 習慣 Vim 操作可開啟

替代方案:QDevelop(輕量級)


sudo apt install qdevelop

優點:啟動快、介面簡潔、與 Qt Designer 整合良好。缺點:功能不如 Qt Creator 完整(無 Analyzer、無 Clangd、重構弱)。適合輕量專案或老舊硬體。

專案建構範例 (CMake + Qt 6)


cmake_minimum_required(VERSION 3.16)
project(MyApp LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

find_package(Qt6 REQUIRED COMPONENTS Core Widgets Sql Charts)

add_executable(MyApp main.cpp MainWindow.cpp MainWindow.ui)
target_link_libraries(MyApp PRIVATE Qt6::Core Qt6::Widgets Qt6::Sql Qt6::Charts)

常見問題

找不到 QMYSQL 驅動
安裝 libqt6sql6-mysql / libqt5sql5-mysql,確認 plugins/sqldrivers/libqsqlmysql.so 存在,檢查 LD_LIBRARY_PATH 含 MySQL client lib 路徑
Qt Designer 無 Qwt 元件
安裝對應 libqwt-qt6-dev,重啟 Qt Creator,檢查 About Qt Designer → Plugins 是否載入 libqwt_designer_plugin.so
編譯錯誤 Qt6::Core not found
確認 qt6-base-dev 已裝,CMake 版本 ≥ 3.16,find_package(Qt6 REQUIRED) 大小寫正確
高 DPI 模糊
QApplication::setAttribute(Qt::AA_EnableHighDpiScaling); (Qt 5)
Qt 6 預設啟用,若仍模糊檢查桌面縮放設定

總結

現代 Ubuntu 上建立 Qt 開發環境極簡單:apt install qt6-base-dev qt6-tools qtcreator cmake g++ libqt6sql6-mysql libqwt-qt6-dev 一行搞定核心工具鏈。專案採用 CMake,IDE 用 Qt Creator,即可高效開發跨平台 GUI 應用。

copyright © 萬盛學電腦網 all rights reserved