以下是在 Ubuntu 中配置 VSCode + Qt + qmake 開發環境的詳細步驟：

1. 安裝 Qt 開發環境

1.1 安裝 Qt 庫和工具

# 更新軟件源
sudo apt update

# 安裝 Qt5 核心庫及開發工具（如需要 Qt6，需另從官網安裝）
sudo apt install qtbase5-dev qt5-qmake qtchooser qtcreator

# 可選：安裝其他模塊（如GUI模塊）
sudo apt install qtdeclarative5-dev qttools5-dev

1.2 驗證 qmake

# 查看 qmake 版本及路徑
qmake --version

# 若返回類似 "QMake version 3.1..." 則為成功

2. 安裝 VSCode

2.1 下載并安裝 VSCode

# 下載 .deb 包
wget -O vscode.deb "https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64"

# 安裝
sudo apt install ./vscode.deb

2.2 安裝必備擴展

1. C/C++（微軟官方擴展）：提供代碼補全、調試支持
2. Qt Tools：Qt語法高亮、QML支持
3. Code Runner（可選）：快速運行代碼

3. 配置 VSCode 的 Qt 項目

3.1 創建或打開 Qt 項目

假設項目目錄結構如下：

.
├── main.cpp
├── widget.cpp
├── widget.h
└── myproject.pro

3.2 配置 .vscode 文件夾

在項目根目錄創建 .vscode 文件夾，并添加以下文件：

① tasks.json（構建任務配置）

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "qmake build",
            "type": "shell",
            "command": "qmake",
            "args": ["${workspaceFolder}/myproject.pro"],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        },
        {
            "label": "make",
            "type": "shell",
            "command": "make",
            "group": "build",
            "dependsOn": ["qmake build"]
        },
        {
            "label": "clean",
            "type": "shell",
            "command": "make clean",
            "group": "build"
        }
    ]
}

② launch.json（調試配置）

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch Qt Program",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/myproject",  // 編譯生成的可執行文件路徑
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "preLaunchTask": "make",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

3.3 設置 c_cpp_properties.json（可選）

配置頭文件路徑和編譯指令（避免代碼提示報錯）：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "/usr/include/x86_64-linux-gnu/qt5/**"  // 根據實際路徑調整
            ],
            "defines": [],
            "compilerPath": "/usr/bin/g++",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "linux-gcc-x64"
        }
    ],
    "version": 4
}

4. 編寫并運行項目

4.1 按 Ctrl+Shift+B 執行構建任務

• 選擇 make 自動執行 qmake 生成 Makefile，并編譯項目。

4.2 調試

按 F5 啟動調試，VSCode會自動編譯并運行程序。

5. 常見問題解決

問題 1：無法找到 Qt 頭文件

• 解決：檢查 includePath 中的 Qt 頭文件路徑是否正確，可通過終端查找：

  dpkg -L qtbase5-dev | grep .h
  

問題 2：qmake 未找到

• 解決：確保已安裝 qt5-qmake，或手動指定路徑：

  # 查找 qmake 路徑
  which qmake
  

問題 3：調試時提示權限不足

• 解決：為生成的可執行文件添加執行權限：

  chmod +x myproject
  

6. 補充工具（可選）

• Clang-Format：統一代碼風格
• CMake Tools：如果需要切換為 CMake 構建
• QML Linter：QML語法檢查

按上述步驟完成配置后，即可在 VSCode 中高效開發 Qt 應用！