Webots外部编译C++控制器失败，求VSCode编译方案

问题原因分析 #

• 首次执行%WEBOTS_HOME%\msys64\usr\bin\make.exe提示make: Nothing to be done for 'all'.：默认生成的Makefile中CXX_SOURCES行处于注释状态，外部make无法识别需要编译的源文件，因此判定无任务可执行。
• 修改CXX_SOURCES后出现链接错误：未正确配置Webots的库依赖路径，导致编译器找不到Webots Robot类的实现文件，触发未定义引用错误。

步骤1：修正Makefile配置 #

打开自动生成的Makefile，完成以下修改：

1. 取消第42行CXX_SOURCES的注释，指定你的源文件：

   CXX_SOURCES = my_controller.cpp
   

2. 确保WEBOTS_HOME环境变量已正确设置（你的环境为D:\Webots），若未设置，可在Makefile顶部手动添加：

   WEBOTS_HOME = D:/Webots
   

3. 删除手动创建的build/release文件夹，Makefile会自动处理目录创建，手动创建可能引发路径或权限冲突。

步骤2：在VSCode中配置编译环境 #

配置tasks.json（编译任务） #

1. 打开VSCode并进入控制器文件夹my_controller。
2. 按Ctrl+Shift+B，选择「创建tasks.json文件」，再选「Others」模板。
3. 将内容替换为以下配置（适配你的MinGW和Webots路径）：

   {
       "version": "2.0.0",
       "tasks": [
           {
               "label": "Webots C++ Build",
               "type": "shell",
               "command": "${env:WEBOTS_HOME}/msys64/usr/bin/make.exe",
               "args": [],
               "group": {
                   "kind": "build",
                   "isDefault": true
               },
               "problemMatcher": ["$gcc"],
               "detail": "使用Webots自带make工具编译C++控制器"
           },
           {
               "label": "Webots C++ Clean",
               "type": "shell",
               "command": "${env:WEBOTS_HOME}/msys64/usr/bin/make.exe",
               "args": ["clean"],
               "problemMatcher": [],
               "detail": "清理编译产物"
           }
       ]
   }
   

   若WEBOTS_HOME未在系统环境变量中设置，直接将command路径改为D:/Webots/msys64/usr/bin/make.exe即可。

配置c_cpp_properties.json（代码补全与语法检查） #

1. 按Ctrl+Shift+P，输入「C/C++: Edit Configurations (JSON)」打开配置文件。
2. 将内容替换为以下配置，确保包含Webots的头文件路径：

   {
       "configurations": [
           {
               "name": "Win32",
               "includePath": [
                   "${workspaceFolder}/**",
                   "${env:WEBOTS_HOME}/include/**",
                   "${env:WEBOTS_HOME}/include/controller/cpp/**"
               ],
               "defines": [
                   "_DEBUG",
                   "UNICODE",
                   "_UNICODE"
               ],
               "compilerPath": "D:/MinGW/bin/g++.exe",
               "cStandard": "c17",
               "cppStandard": "c++17",
               "intelliSenseMode": "windows-gcc-x86"
           }
       ],
       "version": 4
   }
   

   若WEBOTS_HOME未设置环境变量，直接替换为D:/Webots的绝对路径。

步骤3：执行编译 #

1. 按Ctrl+Shift+B，选择「Webots C++ Build」即可启动编译。
2. 编译成功后，build/release目录下会生成my_controller.exe，可直接在Webots中加载使用。

额外注意事项 #

• 必须使用Webots自带的make.exe（%WEBOTS_HOME%\msys64\usr\bin\make.exe），避免与系统中其他版本的make产生环境冲突。
• 若仍出现链接错误，检查${WEBOTS_HOME}/lib目录下是否存在Webots的C++库文件（如libController.dll），确保路径配置正确。
• 编译前可先执行「Webots C++ Clean」任务清理旧产物，避免缓存干扰。

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