首页 > 其他分享 >VSCode + Qt + QMake 开发编译环境搭建

VSCode + Qt + QMake 开发编译环境搭建

时间:2024-07-03 10:46:18浏览次数:20  
标签:exe Qt VSCode make QMake qmake debug build

鉴于Qt官方IDE太过难用,VSCode+各种插件功能强大,遂采用VSCode来写Qt项目;

本博客在 Windows 平台进行指导操作,Mac、Linux 平台配置方式类似,学习其本质就可。

前置准备

  • VSCode,最新版本即可
  • 本地 Qt 环境,版本随意,本文主要针对较老版本使用Qmake构建系统的项目

环境变量

  • Qt 环境变量,需要配置 Qt 库跟 MinGW,尽量使用 Qt 安装时自带的 MinGW

  • VSCode插件,下面 C/C++ 插件是必需的

    C/C++

    Qt tools

开始配置

1、创建项目项目

先用 Qt Creator 创建个Qmake项目,最简单的空白窗口,项目结构如下

2、使用VSCode打开项目

3、配置C/C++插件

VSCode快捷键 ctrl+shift+p 打开命令面板,输入c++,选择编辑配置

Open Setting

4、编辑C/C++设置

  • 编译器路径:下拉有得选就选你配置环境变量的Qt版本,没有就自己复制路径过来

    GCC Path

  • IntelliSense 模式:选择安装的gcc的架构,我安装的是64位Qt,上面自带的gcc编译器也是64位,就选择windows-gcc-x64

    IntelliSense 模式

  • 头文件路径:这个主要是实现头文件识别,要不然Qt的头文件一直飘红,也没法自动跳转头文件,第一行是当前像目录下所有,第二行是安装的Qt库的头文件路径

    头文件路径

  • 剩下的配置按需配置,不配置也不影响。选择编辑json可以查看C/C++插件json版本的配置

  • 刚才配置的都在这里面了,现在引用Qt头文件已经不报错了 c_cpp_properties.json

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**",
                "D:/software/language/qt/5.15.2/mingw81_64/include/**"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "compilerPath": "D:/software/language/qt/Tools/mingw810_64/bin/g++.exe",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

5、配置task.json

  • 选择 终端-运行任务-配置任务-使用模板创建task.json文件-Others ;这一步无所谓,就是搞个模板,用我下面贴的一样

image

  • 配置编译 Qt 项目的 task,这一步其实是跟Qt Creator相同的,我们打开Qt Creator,选择项目,查看刚才的项目的项目构建配置

Qt Creator构建步骤分析如下:

  • 设置构建目录,也就是编译出来的中间文件目录
  • qmake,这一步其实是用qmake.pro配置文件编译成makefile,并且将其中涉及的.ui、.qrc等编译成cpp,都在构建目录中,下面是切换Debug/Release时不同的qmake编译命令
# Debug
D:/software/language/qt/5.15.2/mingw81_64/bin/qmake.exe D:\Coding\temp\test_demo\test_demo.pro -spec win32-g++ "CONFIG+=debug" "CONFIG+=qml_debug" && D:/software/language/qt/Tools/mingw810_64/bin/mingw32-make.exe qmake_all

# Release
D:/software/language/qt/5.15.2/mingw81_64/bin/qmake.exe D:\Coding\temp\test_demo\test_demo.pro -spec win32-g++ "CONFIG+=qtquickcompiler" && D:/software/language/qt/Tools/mingw810_64/bin/mingw32-make.exe qmake_all
  • make,真正的编译cpp,MinGW使用的式 mingw32-make.exe
mingw32-make.exe -j12 in D:\Coding\temp\test_demo\build\Debug
  • clean,这里使用还是`mingw32-make.exe
mingw32-make.exe clean -j12 in D:\Coding\temp\test_demo\build\Debug

将上面Qt Creator构建步骤转换为task.json就行了,把debug、relese全流程都加上了,非常简单!

此外需要注意的是,如果没有配置环境变量的话,直接运行生成的 exe (即运行 run-debug/release)时会提示缺少一些列 dll 文件,此时需要手动补全。

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            //在当前项目目录创建build文件夹
            "label": "mkdir", //任务名称
            "type": "shell", //任务类型,定义任务是被作为进程运行还是在 shell 中作为命令运行。
            "options": {
                "cwd": "${workspaceFolder}" //已执行程序或脚本的当前工作目录,设置当前项目文件夹
            },
            "command": "mkdir", //命令
            "args": [ //命令后面跟的参数
                "-Force",
                "build"
            ]
        },
        {
            "label": "qmake-debug",
            "type": "shell",
            "options": {
                "cwd": "${workspaceFolder}/build" //进入build目录
            },
            "command": "qmake", //qmake命令,这里没用完整路径,是因为配置到环境变量了 C:/Qt/5.15.2/mingw81_64/bin/qmake.exe
            "args": [ //跟的参数是不是很熟悉,就是上面分析出来的Qt Creator执行流程
                "../${workspaceFolderBasename}.pro", //在build目录上一级哦
                "-spec",
                "win32-g++",
                "\"CONFIG+=debug\"",
                "\"CONFIG+=qml_debug\"" // qml 和 widget 项目在此存在差异
            ],
            "dependsOn": [ //这是本条命令依赖的前置条件,就是上面创建build文件夹的task,直接执行本task会自动先调用依赖的task
                "mkdir" //其实可以手动执行一次,后面不用每次都执行创建目录的操作
            ]
        },
        {
            "label": "make-debug",
            "type": "shell",
            "options": {
                "cwd": "${workspaceFolder}/build"
            },
            "command": "mingw32-make", //MinGW这个也配置在环境变量了,不用写完整路径了 C:/Qt/Tools/mingw810_64/bin/mingw32-make.exe
            "args": [
                "-f",
                "Makefile.Debug", //-f 选择makefile,这是qmake编译出来的
                "-j7" //这个参数都知道吧,编译用的线程数量
            ],
            "dependsOn": [
                "qmake-debug"
            ]
        },
        {
            "label": "run-debug",
            "type": "process", //运行就不能选择shell执行了,要选择process
            "options": {
                "cwd": "${workspaceFolder}/build/debug" //没在.pro配置DESTDIR,会生成到build目录下面对应目录
            },
            "command": "${workspaceFolderBasename}.exe", //执行的exe名字,一般当前项目文件夹的名称,自定义可以写其他的
            "dependsOn": [
                "make-debug"
            ]
        },
        {
            "label": "qmake-release",
            "type": "shell",
            "options": {
                "cwd": "${workspaceFolder}/build"
            },
            "command": "qmake",
            "args": [ //注意release跟debug参数的差异
                "../${workspaceFolderBasename}.pro",
                "-spec",
                "win32-g++",
                "\"CONFIG+=qtquickcompiler\""
            ],
            "dependsOn": [
                // "mkdir" //不用每次都创建吧
            ]
        },
        {
            "label": "make-release",
            "type": "shell",
            "options": {
                "cwd": "${workspaceFolder}/build"
            },
            "command": "mingw32-make",
            "args": [
                "-f",
                "Makefile.Release", //注意release跟debug参数的差异
                "-j7"
            ],
            "dependsOn": [
                "qmake-release"
            ]
        },
        {
            "label": "run-release",
            "type": "process",
            "options": {
                "cwd": "${workspaceFolder}/build/release"
            },
            "command": "${workspaceFolderBasename}.exe",
            "dependsOn": [
                "make-release"
            ]
        },
        {
            "label": "clean",
            "type": "shell",
            "options": {
                "cwd": "${workspaceFolder}/build"
            },
            "command": "mingw32-make",
            "args": [
                "clean"
            ]
        }
    ]
}

既然配置好了,那就可以开心的运行代码,有两种方式

  • 终端-运行任务-选择任务,我们配置的task都在里面了,选择run-debug/run-release就行,因为配置过depend[],前面qmake、make都被一条龙调用

  • 既然是VSCode,不用快捷键怎么可以,超级强大的ctrl+shift+p,输入run,和手点流程一样,回车,方向键选择run-debug/run-release回车执行就好了

image

  • 一条龙调用的命令在控制台就会有输出了,exe启动后log也会在这输出

6、配置断点调试

上面配置的是以debug/release方式运行程序,那么要打断点调试怎么办呢?

image

选择 c++ 就行,第一个第二个没关系,反正生成的几乎空白的模板

选择创建配置,选择gdb启动作为基础模板,来在上面修改

修改内容如下,我放了自动生成的模板跟修改后的,可以对比看下修改了那些地方,实际使用记得删除哈

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) 启动", //模板,实际使用记得删除
            "type": "cppdbg",
            "request": "launch",
            "program": "输入程序名称,例如 ${workspaceFolder}/a.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/path/to/gdb",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "将反汇编风格设置为 Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ]
        },
        {
            "name": "debug", //修改后
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/build/Debug/${workspaceFolderBasename}.exe", //写完整路径
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}", //工作目录,项目根目录
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "D:/software/language/qt/Tools/mingw810_64/bin/gdb.exe", //选择MinGW中的gdb
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "make-debug", //这跟depend[]很像啊,make就行了,用make编译出exe
        }
    ]
}

运行调试

  • 重新打开调试,刚才配置的调试配置已经存在了

  • 打个断点,点击绿色三角,运行下看看效果

运行效果

  • run-debug及自动生成的目录结构、控制台log,ctrl+c结束程序

  • run-release

  • debug断点调试

标签:exe,Qt,VSCode,make,QMake,qmake,debug,build
From: https://www.cnblogs.com/RioTian/p/18281114

相关文章

  • Vscode编译Keil ARM工程出现未定义标识符的解决办法
    点击拓展c/c++的拓展设置搜索:intellisenseengine更改为如下图设置设置解释:1.C_Cpp:IntelliSenseEnginedefault(默认):此选项表示使用默认的IntelliSense提供程序,这通常是FullIntelliSense模式。它提供最完整和精确的代码补全、错误检查和导航功能,但可能会占用更多的......
  • Qt/C++编写地图应用/离线地图下载/路径规划/轨迹回放/海量点/坐标转换
    一、前言说明这个地图组件写了很多年了,最初设计的比较粗糙,最开始只是为了满足项目需要,并没有考虑太多拓展性,比如最初都是按照百度地图写死在代码中,经过这几年大量的现场实际应用,以及大量的用户提出的改进意见,逐渐萌生了彻底重新编写对应地图相关的代码,比如基类子类的设计,各种功能......
  • vscode setting.json 设置
    常见配置参考{"editor.fontSize":20,//编辑器字体大小"terminal.integrated.fontSize":18, //terminal框的字体大小"editor.tabSize":2,//Tab的大小2个空格"editor.formatOnSave":true,//保存是格式化"prettier.singleQuote"......
  • QT6 CMake项目配置 (Visual Studio)
    QT6CMake项目配置(VisualStudio)上一节已经编译好了动态和静态的QT库,接下来在CMake中引入。这边主要介绍使用VisualStudio的配置方法测试环境首先使用VS创建一个项目来测试CMake能否正常使用。如果是首次打开VS会有个配置主题的界面,自己选一下就好了首先我们来创建一个C......
  • Deepin23RC2 在线安装qt6.7.2
    摘要:        Deepin23RC2在线安装qt6.7.2及配置的操作记录1.下载在线安装器$wgethttps://ftp.fau.de/qtproject/official_releases/online_installers/qt-unified-linux-x64-online.run2. 安装c++/gdb/libxcb-util1/git$sudoaptupdate$sudoaptupgrade......
  • python: create Envircomnet in vscode 创建虚拟机
    先配置python开发环境 1.在搜索栏输入“>"或是用快后键ctrl+shift+P键就会显示”>",再输入"python:"   选择已经安装好的python的版本至当前项目中   2terminal下输入相关命令行操作,选进入虚拟机的的文件夹下cd.venv/scripts再进行激活虚拟机。输入ac......
  • qt 写入xml文件实例
    这个代码示例展示了如何使用QXmlStreamWriter类在Qt中生成一个包含多级节点和属性的XML文档:1#include<QCoreApplication>2#include<QFile>3#include<QXmlStreamWriter>4#include<QDebug>56intmain(intargc,char*argv[])7{8QCoreApplication......
  • 深入理解Qt多线程编程(QtConcurrent)
    多线程编程在现代软件开发中变得越来越重要,它能够提高应用程序的响应速度和处理性能。在Qt框架中,除了QThreadPool,QtConcurrent也是一个强大的工具,用于简化和管理多线程编程。目录概述接口详解QtConcurrent::runQtConcurrent::mapQtConcurrent::mappedQtConcurrent::filt......
  • 深入理解Qt的隐式共享机制
    在Qt中,一个关键的性能优化特性是其数据结构的隐式共享机制,这在Qt的文档和API中常被称为“隐式共享”或“写时复制(Copy-On-Write,COW)”。本文将详细介绍这一机制,并通过QString类的实现代码和相应的反汇编代码来阐释其工作原理。隐式共享的定义和优点隐式共享是一种内存管......
  • Qt/C++开发经验小技巧296-300
    使用QDir::setCurrent设置当前目录后,会影响程序中的所有相对目录的执行,导致可能的意外发生,一般相对目录都默认是可执行文件所在目录,所以如果程序中为了特殊处理临时调用了QDir::setCurrent设置过相对目录,建议处理完成以后立即切换回来。QDir::setCurrent("f:/");QImageimg(":......