如何在Ubuntu上正确配置WXWidgets？头文件报错问题解决

错误根源 #

手动修改代码中的#include路径是错误操作——WXWidgets头文件内部的嵌套引用均采用wx/xxx.h的相对路径格式，强行在前面添加wx-3.0/会导致内部引用无法找到对应文件。正确的处理方式是让编译器知晓头文件的根搜索目录，而非修改代码本身。

正确编译流程 #

1. 恢复原代码的include语句：将修改后的#include <wx-3.0/wx/wxprec.h>改回官方示例的#include <wx/wxprec.h>。
2. 借助wx-config工具生成编译参数：WXWidgets自带的wx-config工具可自动输出正确的编译、链接参数，执行以下命令完成编译：

   g++ wxtest.cpp -o wxtest `wx-config --cxxflags --libs`
   

   • --cxxflags：向编译器传递头文件搜索路径、预定义宏等必要参数
   • --libs：向链接器传递需要关联的WXWidgets库文件信息

VSCode智能提示配置 #

若要让VSCode识别WXWidgets头文件，需在项目的.vscode/c_cpp_properties.json中添加头文件路径：

1. 按下Ctrl+Shift+P，选择C/C++: Edit Configurations (JSON)打开配置文件
2. 在includePath数组中加入/usr/include/wx-3.0，示例配置如下：

   {
       "configurations": [
           {
               "name": "Linux",
               "includePath": [
                   "${workspaceFolder}/**",
                   "/usr/include/wx-3.0"
               ],
               "defines": [],
               "compilerPath": "/usr/bin/g++",
               "cStandard": "c17",
               "cppStandard": "gnu++17",
               "intelliSenseMode": "linux-gcc-x64"
           }
       ],
       "version": 4
   }
   

安装有效性验证 #

执行wx-config --version，若输出3.0.x格式的版本号，说明wx-config工具正常，WXWidgets安装无误。

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