快捷導(dǎo)航

VSCode配置Qt開(kāi)發(fā)環(huán)境的步驟

更新時(shí)間：2025年09月19日 08:29:20 作者：文博那些事

本文詳細(xì)介紹了在VSCode中配置Qt開(kāi)發(fā)環(huán)境的步驟,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

1. 安裝必要的VSCode擴(kuò)展
2. 修改launch.json添加Qt調(diào)試配置
3. 修改tasks.json添加Qt構(gòu)建任務(wù)
4. 創(chuàng)建/更新settings.json添加Qt設(shè)置
5. 創(chuàng)建c_cpp_properties.json配置IntelliSense
6. 設(shè)置環(huán)境變量
7. 構(gòu)建和調(diào)試Qt項(xiàng)目
注意事項(xiàng)

下面是在VSCode中配置Qt開(kāi)發(fā)環(huán)境的詳細(xì)步驟，針對(duì)你的macOS環(huán)境：

1. 安裝必要的VSCode擴(kuò)展

首先需要安裝以下擴(kuò)展：

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

2. 修改launch.json添加Qt調(diào)試配置

打開(kāi) .vscode/launch.json 文件并添加以下配置：

launch.json

{
    "configurations": [
        {
            "name": "C/C++: clang 構(gòu)建和調(diào)試活動(dòng)文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "lldb",
            "preLaunchTask": "C/C++: clang 生成活動(dòng)文件"
        },
        {
            "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構(gòu)建任務(wù)

更新 .vscode/tasks.json 文件添加Qt相關(guān)任務(wù)：

tasks.json

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: clang 生成活動(dòng)文件",
            "command": "/usr/bin/clang",
            "args": [
                "-fcolor-diagnostics",
                "-fansi-escape-codes",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "調(diào)試器生成的任務(wù)。"
        },
        {
            "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. 創(chuàng)建/更新settings.json添加Qt設(shè)置

修改 .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. 創(chuàng)建c_cpp_properties.json配置IntelliSense

創(chuàng)建新文件 .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. 設(shè)置環(huán)境變量

為了確保VSCode能夠正確找到Qt的庫(kù)和工具，在你的 .bash_profile 或 .zshrc 中添加以下環(huán)境變量：

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"

添加后運(yùn)行 source ~/.bash_profile 或 source ~/.zshrc 使更改生效。

7. 構(gòu)建和調(diào)試Qt項(xiàng)目

按 Command+Shift+B 選擇 Qt: Build ShuxueApp 構(gòu)建項(xiàng)目
按 F5 選擇 Qt: Debug ShuxueApp 調(diào)試項(xiàng)目

注意事項(xiàng)

確保將上述配置中的Qt路徑 /Users/admin/Qt/5.12.10/clang_64/ 替換為你實(shí)際的Qt安裝路徑
如果使用CMake而不是qmake構(gòu)建項(xiàng)目，可以相應(yīng)調(diào)整tasks.json中的構(gòu)建命令
對(duì)于QML文件的語(yǔ)法高亮和自動(dòng)完成，Qt Tools擴(kuò)展提供了很好的支持

完成以上配置后，你應(yīng)該可以在VSCode中舒適地進(jìn)行Qt開(kāi)發(fā)了！

到此這篇關(guān)于VSCode配置Qt開(kāi)發(fā)環(huán)境的步驟的文章就介紹到這了,更多相關(guān)VSCode配置Qt開(kāi)發(fā)環(huán)境內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: