vscode+qt+qmake开发环境搭建，史上最全最具体！

00. 前言

​ 鉴于Qt官方IDE太过难用，VSCode＋各种插件功能强大，遂采用VSCode来写Qt项目。
01. 环境搭建

1. 需要安装的软件：

• VSCode，官方最新版就行
  
• Qt，版本随意，本文主要针对较老版本使用Qmake构建体系的项目
  

2. 环境变量：

• Qt环境变量，需要配置Qt库跟MinGW，尽量使用Qt安装时自带的MinGW
  
  
  
  
• VSCode插件，下面C/C++插件是必需的没意见吧
  
  
  
  
  
  
  

02. 开始配置

1. 创建项目项目

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

2. 使用VSCode打开项目

3. 配置C/C++插件

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

4. 编辑C/C++设置

• 编译器路径:下拉有得选就选你配置环境变量的Qt版本，没有就自己复制路径过来
  
  
  
  
• IntelliSense 模式：选择安装的gcc的架构，我安装的是64位Qt，上面自带的gcc编译器也是64位，就选择windows-gcc-x64
  
  
  
  
• 头文件路径：这个主要是实现头文件识别，要否则Qt的头文件一直飘红，也没法自动跳转头文件，第一行是当前像目次下所有，第二行是安装的Qt库的头文件路径
  
  
  
  
• 剩下的配置按需配置，不配置也不影响。选择编辑json可以检察C/C++插件json版本的配置
  
  
  
  刚才配置的都在这里面了，现在引用Qt头文件已经不报错了 c_cpp_properties.json
  
  1. {
  2.     "configurations": [
  3.         {
  4.             "name": "Win32",
  5.             "includePath": [
  6.                 "${workspaceFolder}/**",
  7.                 "C:/Qt/5.15.2/mingw81_64/include/**"
  8.             ],
  9.             "defines": [
  10.                 "_DEBUG",
  11.                 "UNICODE",
  12.                 "_UNICODE"
  13.             ],
  14.             "intelliSenseMode": "windows-gcc-x64",
  15.             "compilerPath": "C:/Qt/Tools/mingw810_64/bin/g++.exe"
  16.         }
  17.     ],
  18.     "version": 4
  19. }

  复制代码

5. 配置task.json

• 选择终端-运行使命-配置使命-使用模板创建task.json文件-Others；这一步无所谓，就是搞个模板，用我下面贴的一样
  
  
  
  
• 配置编译Qt项目的task，这一步实在是跟Qt Creator相同的，我们打开Qt Creator，选择项目，检察刚才的项目的项目构建配置
  
  
  
  Qt Creator构建步调分析如下：
  
  
  
  • 设置构建目次，也就是编译出来的中央文件目次
    
  • qmake，这一步实在是用qmake将.pro配置文件编译成makefile，并且将其中涉及的.ui、.qrc等编译成cpp，都在构建目次中，下面是切换Debug/Release时不同的qmake编译命令
    
    1. #Debug
    2. C:/Qt/5.15.2/mingw81_64/bin/qmake.exe D:\Code\Other\untitled\untitled.pro -spec win32-g++ "CONFIG+=debug" "CONFIG+=qml_debug" && C:/Qt/Tools/mingw810_64/bin/mingw32-make.exe qmake_all
    4. #Release
    5. C:/Qt/5.15.2/mingw81_64/bin/qmake.exe D:\Code\Other\untitled\untitled.pro -spec win32-g++ "CONFIG+=qml_debug" && C:/Qt/Tools/mingw810_64/bin/mingw32-make.exe qmake_all

    复制代码
  • make，真正的编译cpp，MinGW使用的式mingw32-make.exe
    
    1. mingw32-make.exe -j22 in D:\Code\Other\untitled\build

    复制代码
  • clean，这里使用照旧mingw32-make.exe
    
    1. mingw32-make.exe clean -j20 in D:\Code\Other\untitled\build

    复制代码
  
  
• 将上面Qt Creator构建步调转换为task.json就行了，我把debug、relese全流程都加上了，非常简单！
  
  1. {
  2.     // See https://go.microsoft.com/fwlink/?LinkId=733558
  3.     // for the documentation about the tasks.json format
  4.     "version": "2.0.0",
  5.     "tasks": [
  6.         {
  7.             //在当前项目目录创建build文件夹
  8.             "label": "mkdir", //任务名称
  9.             "type": "shell", //任务类型，定义任务是被作为进程运行还是在 shell 中作为命令运行。
  10.             "options": {
  11.                 "cwd": "${workspaceFolder}" //已执行程序或脚本的当前工作目录，设置当前项目文件夹
  12.             },
  13.             "command": "mkdir", //命令
  14.             "args": [ //命令后面跟的参数
  15.                 "-Force",
  16.                 "build"
  17.             ]
  18.         },
  19.         {
  20.             "label": "qmake-debug",
  21.             "type": "shell",
  22.             "options": {
  23.                 "cwd": "${workspaceFolder}/build" //进入build目录
  24.             },
  25.             "command": "qmake", //qmake命令，这里没用完整路径，是因为配置到环境变量了 C:/Qt/5.15.2/mingw81_64/bin/qmake.exe
  26.             "args": [ //跟的参数是不是很熟悉，就是上面分析出来的Qt Creator执行流程
  27.                 "../${workspaceFolderBasename}.pro", //在build目录上一级哦
  28.                 "-spec",
  29.                 "win32-g++",
  30.                 ""CONFIG+=debug"",
  31.                 ""CONFIG+=console""
  32.             ],
  33.             "dependsOn": [ //这是本条命令依赖的前置条件，就是上面创建build文件夹的task，直接执行本task会自动先调用依赖的task
  34.                 "mkdir" //其实可以手动执行一次，后面不用每次都执行创建目录的操作
  35.             ]
  36.         },
  37.         {
  38.             "label": "make-debug",
  39.             "type": "shell",
  40.             "options": {
  41.                 "cwd": "${workspaceFolder}/build"
  42.             },
  43.             "command": "mingw32-make", //MinGW这个也配置在环境变量了，不用写完整路径了 C:/Qt/Tools/mingw810_64/bin/mingw32-make.exe
  44.             "args": [
  45.                 "-f",
  46.                 "Makefile.Debug", //-f 选择makefile，这是qmake编译出来的
  47.                 "-j7" //这个参数都知道吧，编译用的线程数量
  48.             ],
  49.             "dependsOn": [
  50.                 "qmake-debug"
  51.             ]
  52.         },
  53.         {
  54.             "label": "run-debug",
  55.             "type": "process", //运行就不能选择shell执行了，要选择process
  56.             "options": {
  57.                 "cwd": "${workspaceFolder}/build/debug" //没在.pro配置DESTDIR,会生成到build目录下面对应目录
  58.             },
  59.             "command": "${workspaceFolderBasename}.exe", //执行的exe名字，一般当前项目文件夹的名称，自定义可以写其他的
  60.             "dependsOn": [
  61.                 "make-debug"
  62.             ]
  63.         },
  64.         /
  65.         {
  66.             "label": "qmake-release",
  67.             "type": "shell",
  68.             "options": {
  69.                 "cwd": "${workspaceFolder}/build"
  70.             },
  71.             "command": "qmake",
  72.             "args": [ //注意release跟debug参数的差异
  73.                 "../${workspaceFolderBasename}.pro",
  74.                 "-spec",
  75.                 "win32-g++",
  76.                 ""CONFIG+=qtquickcompiler""
  77.             ],
  78.             "dependsOn": [
  79.                 // "mkdir" //不用每次都创建吧
  80.             ]
  81.         },
  82.         {
  83.             "label": "make-release",
  84.             "type": "shell",
  85.             "options": {
  86.                 "cwd": "${workspaceFolder}/build"
  87.             },
  88.             "command": "mingw32-make",
  89.             "args": [
  90.                 "-f",
  91.                 "Makefile.Release", //注意release跟debug参数的差异
  92.                 "-j7"
  93.             ],
  94.             "dependsOn": [
  95.                 "qmake-release"
  96.             ]
  97.         },
  98.         {
  99.             "label": "run-release",
  100.             "type": "process",
  101.             "options": {
  102.                 "cwd": "${workspaceFolder}/build/release"
  103.             },
  104.             "command": "${workspaceFolderBasename}.exe",
  105.             "dependsOn": [
  106.                 "make-release"
  107.             ]
  108.         },
  109.         {
  110.             "label": "clean",
  111.             "type": "shell",
  112.             "options": {
  113.                 "cwd": "${workspaceFolder}/build"
  114.             },
  115.             "command": "mingw32-make",
  116.             "args": [
  117.                 "clean"
  118.             ]
  119.         }
  120.     ]
  121. }

  复制代码
• 既然配置好了，那就可以开心的运行代码，有两种方式
  
  
  
  • 终端-运行使命-选择使命，我们配置的task都在里面了，选择run-debug/run-release就行，因为配置过depend[]，前面qmake、make都被一条龙调用
    
    
    
    
  • 既然是VSCode，不消快捷键怎么可以，超级强大的ctrl+shift+p，输入run，和手点流程一样，回车，方向键选择run-debug/run-release回车实行就好了
    
    
    
    一条龙调用的命令在控制台就会有输出了，exe启动后log也会在这输出
    
    
    
    
  
  

03. 配置断点调试

​ 上面配置的是以debug/release方式运行程序，那么要打断点调试怎么办呢？
1.配置launch.json

• 侧边栏选择调试，点击创建launch.json文件
  
  
  
  
• 选择c++就行，第一个第二个不要紧，反正天生的几乎空白的模板
  
  
  
  
• 选择创建配置，选择gdb启动作为基础模板，来在上面修改
  
  
  
  
• 修改内容如下，我放了自动天生的模板跟修改后的，可以对比看下修改了那些地方，实际使用记得删除哈
  
  1. {
  2.     // 使用 IntelliSense 了解相关属性。
  3.     // 悬停以查看现有属性的描述。
  4.     // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
  5.     "version": "0.2.0",
  6.     "configurations": [
  7.         {
  8.             "name": "(gdb) 启动", //模板，实际使用记得删除
  9.             "type": "cppdbg",
  10.             "request": "launch",
  11.             "program": "输入程序名称，例如 ${workspaceFolder}/a.exe",
  12.             "args": [],
  13.             "stopAtEntry": false,
  14.             "cwd": "${fileDirname}",
  15.             "environment": [],
  16.             "externalConsole": false,
  17.             "MIMode": "gdb",
  18.             "miDebuggerPath": "/path/to/gdb",
  19.             "setupCommands": [
  20.                 {
  21.                     "description": "为 gdb 启用整齐打印",
  22.                     "text": "-enable-pretty-printing",
  23.                     "ignoreFailures": true
  24.                 },
  25.                 {
  26.                     "description": "将反汇编风格设置为 Intel",
  27.                     "text": "-gdb-set disassembly-flavor intel",
  28.                     "ignoreFailures": true
  29.                 }
  30.             ]
  31.         },
  32.         {
  33.             "name": "debug", //修改后
  34.             "type": "cppdbg",
  35.             "request": "launch",
  36.             "program": "${workspaceFolder}/build/debug/${workspaceFolderBasename}.exe", //写完整路径
  37.             "args": [],
  38.             "stopAtEntry": false,
  39.             "cwd": "${workspaceFolder}", //工作目录，项目根目录
  40.             "environment": [],
  41.             "externalConsole": false,
  42.             "MIMode": "gdb",
  43.             "miDebuggerPath": "C:/Qt/Tools/mingw810_64/bin/gdb.exe", //选择MinGW中的gdb
  44.             "setupCommands": [
  45.                 {
  46.                     "description": "为 gdb 启用整齐打印",
  47.                     "text": "-enable-pretty-printing",
  48.                     "ignoreFailures": true
  49.                 }
  50.             ],
  51.             "preLaunchTask": "make-debug", //这跟depend[]很像啊，make就行了，用make编译出exe
  52.         }
  53.     ]
  54. }

  复制代码

2. 运行调试

• 重新打开调试，刚才配置的调试配置已经存在了
  
  
  
  
• 打个断点，点击绿色三角，运行下看看结果
  
  
  
  

04. 运行结果

• run-debug及自动天生的目次结构、控制台log，ctrl+c竣事程序
  
  
  
  
• run-release
  
  
  
  
• debug断点调试
  
  
  
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。