cpptools goto framework headers error

[debugee]

Environment

Version: 1.102.3
Commit: 488a1f239235055e34e673291fb8d8c810886f81
Date: 2025-07-29T03:00:23.339Z
Electron: 35.6.0
ElectronBuildId: 11847422
Chromium: 134.0.6998.205
Node.js: 22.15.1
V8: 13.4.114.21-electron.0
OS: Darwin x64 23.6.0

-------- Diagnostics - 2025/10/12 11:38:35
Version: 1.26.5
Current Configuration:
{
"name": "Mac",
"includePath": [
"/Users/admin/Desktop/qt-test/"
],
"defines": [],
"cStandard": "c17",
"cppStandard": "c++17",
"intelliSenseMode": "macos-clang-x64",
"intelliSenseModeIsExplicit": false,
"cStandardIsExplicit": false,
"cppStandardIsExplicit": false,
"mergeConfigurations": false,
"recursiveIncludes": {},
"recursiveIncludesReduceIsExplicit": false,
"recursiveIncludesPriorityIsExplicit": false,
"recursiveIncludesOrderIsExplicit": false,
"compilerPath": "/usr/bin/clang++",
"compilerPathIsExplicit": true,
"configurationProvider": "ms-vscode.cmake-tools",
"browse": {
"limitSymbolsToIncludedHeaders": true
}
}
Modified Settings:
{
"C_Cpp.default.compilerPath": "/usr/bin/clang++"
}
Additional Tracked Settings:
{
"editorTabSize": 4,
"editorInsertSpaces": true,
"editorAutoClosingBrackets": "languageDefined",
"filesEncoding": "utf8",
"filesAssociations": {
".cpp": "cpp",
".qrc": "xml",
"qmainwindow": "cpp",
"qmessagebox": "cpp"
},
"filesExclude": {
"/.git": true,
"/.svn": true,
"/.hg": true,
"/.DS_Store": true,
"/Thumbs.db": true
},
"filesAutoSaveAfterDelay": false,
"editorInlayHintsEnabled": true,
"editorParameterHintsEnabled": true,
"searchExclude": {
"/node_modules": true,
"/bower_components": true,
"**/*.code-search": true
},
"workbenchSettingsEditor": "ui"
}
Custom browse configuration:
{
"browsePath": [
"/Users/admin/Desktop/qt-test-build/CMakeFiles",
"/Users/admin/Desktop/qt-test-build",
"/Users/admin/Desktop/qt-test-build/qt-test_autogen/include",
"/Users/admin/Qt/6.7.2/macos/lib/QtCore.framework/Headers",
"/Users/admin/Qt/6.7.2/macos/mkspecs/macx-clang",
"/Users/admin/Qt/6.7.2/macos/include",
"/Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers",
"/Users/admin/Qt/6.7.2/macos/lib/QtGui.framework/Headers",
"/Users/admin/Desktop/qt-test",
"/Users/admin/Qt/6.7.2/macos/lib",
"/Users/admin/Desktop/qt-test-build/qt-test_autogen",
"/Users/admin/Desktop/qt-test-build/.qt/rcc"
],
"compilerPath": "/usr/bin/clang++",
"compilerArgs": [],
"compilerFragments": [
"-g -std=gnu++17 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk"
]
}
cpptools version (native): 1.26.4.0
Current database path: /Users/admin/Library/Caches/vscode-cpptools/45ab2c909f9b34cdcc4ccd8e6f09dab9/.browse.VC.db
Translation Unit Mappings:
[ /Users/admin/Desktop/qt-test/main.cpp - source TU]:
/Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers/qmainwindow.h
Translation Unit Configurations:
[ /Users/admin/Desktop/qt-test/main.cpp ]
Process ID: 7263
Memory Usage: 15 MB
Compiler Path: /usr/bin/clang++
Include paths:
include: /Users/admin/Desktop/qt-test-build/qt-test_autogen/include
include: /Users/admin/Qt/6.7.2/macos/lib/QtCore.framework/Headers
include: /Users/admin/Qt/6.7.2/macos/mkspecs/macx-clang
include: /Users/admin/Qt/6.7.2/macos/include
include: /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers
include: /Users/admin/Qt/6.7.2/macos/lib/QtGui.framework/Headers
include: /Users/admin/Qt/6.7.2/macos/lib
system include: /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk/usr/include/c++/v1
system include: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/15.0.0/include
system include: /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk/usr/include
system include: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include
system framework search path (default): /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk/System/Library/Frameworks
Defines:
QT_CORE_LIB
QT_GUI_LIB
QT_WIDGETS_LIB
Standard Version: c++17
IntelliSense Mode: macos-clang-x64
Other Flags:
--clang
--clang_version=160000
Total Memory Usage: 15 MB

------- Workspace parsing diagnostics -------
Number of files discovered (not excluded): 18218
Number of files parsed: 1429

my main.cpp use #include can goto /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers/QApplication
but if I use #include <QtWidgets/QApplication> can't goto the file
cpptools not trans <QtWidgets/QApplication> to /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers/QApplication, not find the file

but qt have many internal file use <framework/header.h>

• (i.e. #include <OpenGLES/ES2/gl.h>, mapping to OpenGLES.framework/Headers/ES2/gl.h).

Bug Summary and Steps to Reproduce

Bug Summary:

Steps to reproduce:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior:

Configuration and Logs

-------- Diagnostics - 2025/10/12 11:38:35
Version: 1.26.5
Current Configuration:
{
    "name": "Mac",
    "includePath": [
        "/Users/admin/Desktop/qt-test/**"
    ],
    "defines": [],
    "cStandard": "c17",
    "cppStandard": "c++17",
    "intelliSenseMode": "macos-clang-x64",
    "intelliSenseModeIsExplicit": false,
    "cStandardIsExplicit": false,
    "cppStandardIsExplicit": false,
    "mergeConfigurations": false,
    "recursiveIncludes": {},
    "recursiveIncludesReduceIsExplicit": false,
    "recursiveIncludesPriorityIsExplicit": false,
    "recursiveIncludesOrderIsExplicit": false,
    "compilerPath": "/usr/bin/clang++",
    "compilerPathIsExplicit": true,
    "configurationProvider": "ms-vscode.cmake-tools",
    "browse": {
        "limitSymbolsToIncludedHeaders": true
    }
}
Modified Settings:
{
    "C_Cpp.default.compilerPath": "/usr/bin/clang++"
}
Additional Tracked Settings:
{
    "editorTabSize": 4,
    "editorInsertSpaces": true,
    "editorAutoClosingBrackets": "languageDefined",
    "filesEncoding": "utf8",
    "filesAssociations": {
        "*.cpp": "cpp",
        "*.qrc": "xml",
        "qmainwindow": "cpp",
        "qmessagebox": "cpp"
    },
    "filesExclude": {
        "**/.git": true,
        "**/.svn": true,
        "**/.hg": true,
        "**/.DS_Store": true,
        "**/Thumbs.db": true
    },
    "filesAutoSaveAfterDelay": false,
    "editorInlayHintsEnabled": true,
    "editorParameterHintsEnabled": true,
    "searchExclude": {
        "**/node_modules": true,
        "**/bower_components": true,
        "**/*.code-search": true
    },
    "workbenchSettingsEditor": "ui"
}
Custom browse configuration: 
{
    "browsePath": [
        "/Users/admin/Desktop/qt-test-build/CMakeFiles",
        "/Users/admin/Desktop/qt-test-build",
        "/Users/admin/Desktop/qt-test-build/qt-test_autogen/include",
        "/Users/admin/Qt/6.7.2/macos/lib/QtCore.framework/Headers",
        "/Users/admin/Qt/6.7.2/macos/mkspecs/macx-clang",
        "/Users/admin/Qt/6.7.2/macos/include",
        "/Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers",
        "/Users/admin/Qt/6.7.2/macos/lib/QtGui.framework/Headers",
        "/Users/admin/Desktop/qt-test",
        "/Users/admin/Qt/6.7.2/macos/lib",
        "/Users/admin/Desktop/qt-test-build/qt-test_autogen",
        "/Users/admin/Desktop/qt-test-build/.qt/rcc"
    ],
    "compilerPath": "/usr/bin/clang++",
    "compilerArgs": [],
    "compilerFragments": [
        "-g -std=gnu++17 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk"
    ]
}
cpptools version (native): 1.26.4.0
Current database path: /Users/admin/Library/Caches/vscode-cpptools/45ab2c909f9b34cdcc4ccd8e6f09dab9/.browse.VC.db
Translation Unit Mappings:
[ /Users/admin/Desktop/qt-test/main.cpp - source TU]:
    /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers/qmainwindow.h
Translation Unit Configurations:
[ /Users/admin/Desktop/qt-test/main.cpp ]
    Process ID: 7263
    Memory Usage: 15 MB
    Compiler Path: /usr/bin/clang++
    Include paths:
        include: /Users/admin/Desktop/qt-test-build/qt-test_autogen/include
        include: /Users/admin/Qt/6.7.2/macos/lib/QtCore.framework/Headers
        include: /Users/admin/Qt/6.7.2/macos/mkspecs/macx-clang
        include: /Users/admin/Qt/6.7.2/macos/include
        include: /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers
        include: /Users/admin/Qt/6.7.2/macos/lib/QtGui.framework/Headers
        include: /Users/admin/Qt/6.7.2/macos/lib
        system include: /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk/usr/include/c++/v1
        system include: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/15.0.0/include
        system include: /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk/usr/include
        system include: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include
        system framework search path (default): /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.5.sdk/System/Library/Frameworks
    Defines:
        QT_CORE_LIB
        QT_GUI_LIB
        QT_WIDGETS_LIB
    Standard Version: c++17
    IntelliSense Mode: macos-clang-x64
    Other Flags:
        --clang
        --clang_version=160000
Total Memory Usage: 15 MB

------- Workspace parsing diagnostics -------
Number of files discovered (not excluded): 18218
Number of files parsed: 1429

Other Extensions

No response

Additional context

No response

[sean-mcmanus]

@debugee You have framework paths being specified as an include instead of as a framework path. Can you try setting macFrameworkPath? However, if you're using CMake Tools, you may need to configure that to send the frameworks.

[bobbrow]

Support for mac frameworks was added to CMake Tools a while ago. microsoft/vscode-cmake-tools#3247. Though it does require a recent version of CMake. Setting a mac framework path in the include path is supposed to work (or maybe I'm confusing that with the tag parser configuration which I know for sure handles it).

include: /Users/admin/Qt/6.7.2/macos/lib - This is the framework path which is showing up in the include path instead of the framework path. (Again, I thought that IntelliSense could handle it this way though)

#include <QtWidgets/QApplication> is the correct way to use the framework headers, so once we determine that the configuration issue is solved, we can figure out if there are still issues with go to definition or the red squiggles.

[debugee]

#include < QApplication > (include framework header method like this we call it M1)
#include <QtWidgets/QApplication> (include framework header method like this we call it M2)

microsoft/vscode-cmake-tools#3247 not solve M2

clang compile the source file with M2 or M1 is all ok

clang compiler flag -iframework /Users/admin/Qt/6.7.2/macOS/lib for find M2
clang compiler flag -isystem /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers for find M1

1、clang -std=gnu++17 -c mainwindow.cpp -isystem /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers -iframework /Users/admin/Qt/6.7.2/macOS/lib
2、clang -std=gnu++17 -c mainwindow.cpp -iframework /Users/admin/Qt/6.7.2/macOS/lib
3、clang -std=gnu++17 -c mainwindow.cpp -isystem /Users/admin/Qt/6.7.2/macos/lib/QtWidgets.framework/Headers

1、compile ok
2、compile not find QMainWindow
3、compile not find QtWidgets/qtwidgetsglobal.h

also see #13204

[debugee]

Support for mac frameworks was added to CMake Tools a while ago. microsoft/vscode-cmake-tools#3247. Though it does require a recent version of CMake. Setting a mac framework path in the include path is supposed to work (or maybe I'm confusing that with the tag parser configuration which I know for sure handles it).

include: /Users/admin/Qt/6.7.2/macos/lib - This is the framework path which is showing up in the include path instead of the framework path. (Again, I thought that IntelliSense could handle it this way though)

#include <QtWidgets/QApplication> is the correct way to use the framework headers, so once we determine that the configuration issue is solved, we can figure out if there are still issues with go to definition or the red squiggles.

这应该是个bug吧？cpptools应该通过编译参数 自动实现goto，而不是需要添加浏览路径或者include路径，而且路径已经被cmaketools自动添加了，请你确认一下这个问题，很影响我的体验