本文参考Windows Qt Creator WSL Ubuntu 编译 x86_64 Linux 程序环境搭建说明一、开启WSL功能1.1、进入Windows功能先WinR键弹出运行框输入“optionalfeatures”1.2、勾选功能勾选“虚拟机平台”和“适用于Linux 的Windows子系统”这两项功能启用后需重启电脑。1.3、检验wsl命令更新wsl为最新版本第一次会自动下载。wsl --update⚠️ 注意wsl --update本身下载慢可在浏览器/下载工具中手动下载最新 MSI 安装包Releases · microsoft/WSL · GitHub1.4、将 WSL 2 设置为默认版本wsl --set-default-version 2二、安装Ubuntu26.042.1、安装Ubuntu方式一wsl自动下载安装# 查看当前可安装的Linux发行版本 wsl -l -o # 安装Ubuntu26.04 wsl --install Ubuntu-26.04方式二离线下载下载Ubuntu26.04 WSL版镜像双击安装包导入下载连接ubuntu-releases/26.04 | 清华大学开源软件镜像站安装完成后可验证wsl -l -v2.2、更换Ubuntu软件源替换命令sudo sed -i s|http://archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g /etc/apt/sources.list.d/ubuntu.sources替换安全更新源可选sudo sed -i s|http://security.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g /etc/apt/sources.list.d/ubuntu.sources三、安装Linux编译工具和 Qt 库C/C开发环境包名作用gC编译器cmake现代C项目构建生成器ninja-build高效执行增量编译与并行构建任务gdbUbuntu本地调试器gdbserverssh远程调试gdbopenssh-serverssh服务器Qt6开发环境包名作用qt6-base-devQt6核心开发组件包Widgets、Gui 、Core、SerialPort、Network、SQL、Wayland等基础模块的头文件库、qmakeqt6-declarative-devQML/Quick 支持如需要# 更新软件包索引 sudo apt update # 安装所需的依赖包 sudo apt install g cmake ninja-build gdb gdbserver openssh-server qt6-base-dev qt6-declarative-dev -y四、配置Qt Creator中SSH远程开发4.1、添加Remote Linux Device编辑-Preferences-设备-添加输入IP地址若使用localhost时多个Linux同时运行请勿使用同一个端口和用户名。创建ssh密钥对4.2、一键生成Linux Qt6 kit4.3、配置CMake使用Ninja构建五、创建Qt6CMake项目5.1、创建Linux项目第一步创建项目第二步选择远程目录(非root只能home目录中存放)5.2、Qt6使用Wayland渲染GUI在 C 代码中强制 Qt6 使用 Wayland 平台WSLg支持Wayland显示。#include QGuiApplication #include QQmlApplicationEngine int main(int argc, char *argv[]) { // ⚠️ 必须在 QApplication 构造之前调用 qputenv(QT_QPA_PLATFORM, wayland); QGuiApplication app(argc, argv); QQmlApplicationEngine engine; QObject::connect( engine, QQmlApplicationEngine::objectCreationFailed, app, []() { QCoreApplication::exit(-1); }, Qt::QueuedConnection); engine.loadFromModule(untitled, Main); return QGuiApplication::exec(); }5.3、解决Qt Creator无法在Linux SSH无法代码补全解决参考Ubuntu QtCreator没有任何的代码提示和自动补全帮助→已安装插件关闭Clang Code Model这个插件重启Qt Creator
