Ubuntu系统下VSCode编写C++ Qt项目时找不到Qt头文件路径如何解决

你之前添加的/usr/lib/x86_64-linux-gnu是Qt动态库存放路径，不是头文件路径，因此无法解决头文件找不到的报错。

步骤1：确认Qt头文件根目录 #

apt安装的Qt5 #

执行以下命令定位QApplication头文件位置：
dpkg -L qtbase5-dev | grep "include/QApplication"
正常返回结果类似/usr/include/x86_64-linux-gnu/qt5/QtWidgets/QApplication，即可确定Qt根头文件目录为/usr/include/x86_64-linux-gnu/qt5。

官网安装包安装的Qt #

头文件路径为安装目录下对应版本的gcc架构目录的include文件夹，比如安装路径为~/Qt，Qt版本为5.15.2，根头文件目录为~/Qt/5.15.2/gcc_64/include。

步骤2：修改c_cpp_properties.json配置 #

在配置文件的includePath数组中添加以下路径，可根据实际使用的Qt模块增减：

• [Qt根头文件目录]
• [Qt根头文件目录]/QtCore
• [Qt根头文件目录]/QtGui
• [Qt根头文件目录]/QtWidgets
  用到其他Qt模块（如QtNetwork、QtSql等）时，对应添加[Qt根头文件目录]/[模块名]即可。

同时建议在defines数组中添加对应宏定义，避免Qt语法识别报错：

• QT_CORE_LIB
• QT_GUI_LIB
• QT_WIDGETS_LIB
  用到其他模块时添加对应QT_[模块名大写]_LIB格式的宏即可。

可选优化方案 #

如果使用CMake或QMake管理项目，无需手动配置路径，只需在构建时生成compile_commands.json文件，再在c_cpp_properties.json中添加配置项：
"compileCommands": "${workspaceFolder}/你的构建目录名称/compile_commands.json"
C/C++插件会自动识别所有Qt头文件路径，无需手动添加。

内容的提问来源于stack exchange，提问作者Synectome