如何在Ubuntu 20.04中安装特定版本Qt 5.9库

Ubuntu 20.04的官方软件源默认提供Qt 5.12版本，无法通过sudo apt install qt5-default直接获取Qt 5.9。针对现场设备已有固定Qt动态库的兼容性需求，你可以通过以下两种方式安装指定版本：

方法一：使用Qt官方离线安装包 #

这是最快捷的方式，适合不需要自定义编译参数的场景：

• 下载对应版本的Qt 5.9离线安装包（例如Qt 5.9.9的Linux 64位版本）
• 给安装包添加执行权限：

  chmod +x qt-opensource-linux-x64-5.9.9.run
  

• 运行安装包，在向导中选择需要的组件（务必勾选Qt 5.9.x的GCC 64-bit版本），将其安装到自定义路径（推荐/opt/Qt5.9.9）
• 配置环境变量，让系统优先使用该版本：
  编辑~/.bashrc文件，添加以下内容：

  export PATH=/opt/Qt5.9.9/5.9.9/gcc_64/bin:$PATH
  export LD_LIBRARY_PATH=/opt/Qt5.9.9/5.9.9/gcc_64/lib:$LD_LIBRARY_PATH
  export QT_PATH=/opt/Qt5.9.9/5.9.9/gcc_64
  

  执行source ~/.bashrc使配置生效
• 验证安装：运行qmake -v，输出应显示Qt 5.9.x版本信息

方法二：手动编译Qt 5.9源码 #

如果需要自定义编译参数（比如禁用某些模块、开启特定功能），可以选择源码编译：

• 先安装编译依赖：

  sudo apt install build-essential libfontconfig1-dev libfreetype6-dev libx11-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libxcb-glx0-dev libxcb-keysyms1-dev libxcb-image0-dev libxcb-shm0-dev libxcb-icccm4-dev libxcb-sync0-dev libxcb-xfixes0-dev libxcb-shape0-dev libxcb-randr0-dev libxcb-render-util0-dev libxcb-util-dev libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev
  

• 下载Qt 5.9.x源码包并解压到本地目录（例如~/qt5.9-src）
• 进入源码目录，配置编译选项（以下是基础配置示例，可根据需求调整）：

  cd ~/qt5.9-src
  ./configure -prefix /opt/Qt5.9.9 -opensource -confirm-license -release -nomake examples -nomake tests -qt-zlib -qt-libpng -qt-libjpeg
  

• 编译并安装（-j$(nproc)会利用所有CPU核心加速编译）：

  make -j$(nproc)
  sudo make install
  

• 同样配置环境变量并验证版本，步骤同方法一

关键注意事项 #

• 确保安装的Qt 5.9版本与现场设备的Qt库完全一致（包括小版本号，如5.9.9），编译选项也要尽量匹配，避免兼容性问题
• 若使用Qt Creator开发，需在IDE中添加新的Kit，指定qmake路径为/opt/Qt5.9.9/5.9.9/gcc_64/bin/qmake
• 如需切换系统默认qmake版本，可使用update-alternatives管理：

  sudo update-alternatives --install /usr/bin/qmake qmake /opt/Qt5.9.9/5.9.9/gcc_64/bin/qmake 100
  sudo update-alternatives --config qmake
  

内容的提问来源于stack exchange，提问作者Stef