VSCode配置Qt开发环境的步骤

更新时间：2025年09月19日 08:29:20 作者：文博那些事

本文详细介绍了在VSCode中配置Qt开发环境的步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

1. 安装必要的VSCode扩展

首先需要安装以下扩展：

C/C++ (Microsoft)
CMake Tools (Microsoft)
Qt Tools (tonka3000)

2. 修改launch.json添加Qt调试配置

打开 .vscode/launch.json 文件并添加以下配置：

launch.json

{
    "configurations": [
        {
            "name": "C/C++: clang 构建和调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "lldb",
            "preLaunchTask": "C/C++: clang 生成活动文件"
        },
        {
            "name": "Qt: Debug ShuxueApp",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/build-ShuxueApp-Desktop_Qt_5_12_10_clang_64bit-Debug/ShuxueApp.app/Contents/MacOS/ShuxueApp",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [
                {
                    "name": "DYLD_LIBRARY_PATH",
                    "value": "/Users/admin/Qt/5.12.10/clang_64/lib"
                }
            ],
            "externalConsole": false,
            "MIMode": "lldb",
            "preLaunchTask": "Qt: Build ShuxueApp"
        }
    ],
    "version": "2.0.0"
}

3. 修改tasks.json添加Qt构建任务

更新 .vscode/tasks.json 文件添加Qt相关任务：

tasks.json

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: clang 生成活动文件",
            "command": "/usr/bin/clang",
            "args": [
                "-fcolor-diagnostics",
                "-fansi-escape-codes",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "调试器生成的任务。"
        },
        {
            "label": "Qt: Build ShuxueApp",
            "type": "shell",
            "command": "qmake && make",
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "group": "build",
            "problemMatcher": [
                "$gcc"
            ]
        },
        {
            "label": "Qt: Clean",
            "type": "shell",
            "command": "make clean",
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "group": "build",
            "problemMatcher": []
        }
    ],
    "version": "2.0.0"
}

4. 创建/更新settings.json添加Qt设置

修改 .vscode/settings.json 文件：

settings.json

{
    "git.ignoreLimitWarning": true,
    "qttools.qmakePath": "/Users/admin/Qt/5.12.10/clang_64/bin/qmake",
    "qttools.cmakePath": "/Applications/CMake.app/Contents/bin/cmake",
    "C_Cpp.default.includePath": [
        "${workspaceFolder}/**",
        "/Users/admin/Qt/5.12.10/clang_64/include/**"
    ],
    "C_Cpp.default.defines": [],
    "C_Cpp.default.compilerPath": "/usr/bin/clang",
    "C_Cpp.default.cStandard": "c11",
    "C_Cpp.default.cppStandard": "c++11"
}

5. 创建c_cpp_properties.json配置IntelliSense

创建新文件 .vscode/c_cpp_properties.json：

c_cpp_properties.json

Apply

{
    "configurations": [
        {
            "name": "Mac",
            "includePath": [
                "${workspaceFolder}/**",
                "/Users/admin/Qt/5.12.10/clang_64/include/**"
            ],
            "defines": [],
            "macFrameworkPath": [
                "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks"
            ],
            "compilerPath": "/usr/bin/clang",
            "cStandard": "c11",
            "cppStandard": "c++11",
            "intelliSenseMode": "macos-clang-x64"
        }
    ],
    "version": 4
}

6. 设置环境变量

为了确保VSCode能够正确找到Qt的库和工具，在你的 .bash_profile 或 .zshrc 中添加以下环境变量：

export PATH="/Users/admin/Qt/5.12.10/clang_64/bin:$PATH"
export DYLD_LIBRARY_PATH="/Users/admin/Qt/5.12.10/clang_64/lib:$DYLD_LIBRARY_PATH"

添加后运行 source ~/.bash_profile 或 source ~/.zshrc 使更改生效。

7. 构建和调试Qt项目

按 Command+Shift+B 选择 Qt: Build ShuxueApp 构建项目
按 F5 选择 Qt: Debug ShuxueApp 调试项目

注意事项

确保将上述配置中的Qt路径 /Users/admin/Qt/5.12.10/clang_64/ 替换为你实际的Qt安装路径
如果使用CMake而不是qmake构建项目，可以相应调整tasks.json中的构建命令
对于QML文件的语法高亮和自动完成，Qt Tools扩展提供了很好的支持

完成以上配置后，你应该可以在VSCode中舒适地进行Qt开发了！

到此这篇关于VSCode配置Qt开发环境的步骤的文章就介绍到这了,更多相关VSCode配置Qt开发环境内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

C++ STL list 遍历删除出错解决方案
这篇文章主要介绍了C++ STL list 遍历删除出错解决方案的相关资料,这里对出错进行分析，并给出正确的解决方法，需要的朋友可以参考下
2016-12-12
C++虚函数表深入研究
这篇文章主要介绍了C++的虚函数表，内容非常详细，思路清晰,需要的朋友可以参考下，希望能够给你带来帮助
2021-10-10
Qt实现指针式时钟 Qt实现动态时钟
这篇文章主要为大家详细介绍了Qt实现指针式时钟，Qt实现动态时钟，两者相互切换，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2020-07-07
C语言进阶几分钟带你理解大小端存储模式
这篇文章主要为大家介绍了C语言进阶大小端模式的示例详解，带各位读者朋友五分钟脚踩大小端模式，有需要的朋友可以借鉴参考下，希望能够有所帮助
2022-02-02
visual studio 将编译后的dll等文件自动复制到指定目录的方法
这篇文章主要介绍了visual studio 将编译后的dll等文件自动复制到指定目录,本文给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
2024-03-03
C++中vector容器的常用操作方法实例总结
vector容器一般被用作创建动态数组,动态数组就像Python中的list结构一样,可以比普通数组拥有更丰富操作方法,下面就为大家整理了一些最常用的操作:
2016-05-05
C语言中pthread_create函数实现向线程函数传递参数
本文主要介绍了C语言中pthread_create函数实现向线程函数传递参数，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-05-05
C++无try-catch的异常捕获示例详解
这篇文章主要为大家介绍了C++无try-catch的异常捕获示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-12-12
C语言如何实现翻转字符串中的单词
这篇文章主要介绍了C语言如何实现翻转字符串中的单词，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-07-07
JS调用C++函数抛出异常及捕捉异常详解
这篇文章主要介绍了js调用C++函数的方法示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2021-08-08