在ROS中用Visual Studio Code调试Python脚本：预执行setup.bash方法咨询

我之前调试ROS Python脚本时也遇到过同样的问题——必须先加载ROS的环境变量，脚本才能正确导入rospy这类模块。下面是两种简单有效的实现方式：

方法一：使用预启动任务（Pre-launch Task） #

这种方法会在调试器启动前自动执行source命令，步骤如下：

1. 创建任务配置文件（tasks.json）

   • 按下Ctrl+Shift+B打开任务面板，选择「创建tasks.json文件」，然后选择「Others」模板。
   • 将文件内容替换为以下配置，注意把path_to/setup.bash替换成你实际的setup.bash路径（比如~/catkin_ws/devel/setup.bash）：

     {
         "version": "2.0.0",
         "tasks": [
             {
                 "label": "source_ros_setup",
                 "type": "shell",
                 "command": "source path_to/setup.bash",
                 "options": {
                     "cwd": "${workspaceFolder}"
                 },
                 "problemMatcher": []
             }
         ]
     }
     

2. 修改调试配置文件（launch.json）

   • 打开调试面板（Ctrl+Shift+D），点击「创建launch.json文件」，选择「Python」环境。
   • 在配置中添加preLaunchTask字段，指向我们刚才创建的任务：

     {
         "version": "0.2.0",
         "configurations": [
             {
                 "name": "Python: ROS Script",
                 "type": "python",
                 "request": "launch",
                 "program": "${file}",
                 "console": "integratedTerminal",
                 "preLaunchTask": "source_ros_setup"
             }
         ]
     }
     

这样每次启动调试时，VS Code都会先执行source setup.bash，再启动Python调试器。

方法二：配置终端默认环境变量 #

如果你希望VS Code的所有终端都自动加载ROS环境（包括调试用的终端），可以直接修改VS Code的设置：

1. 按下Ctrl+,打开设置面板，搜索「Terminal > Integrated > Env: Linux」（对应Linux系统，Windows或macOS选对应选项）。
2. 点击「编辑 in settings.json」，添加以下内容（同样替换成你的setup.bash路径）：

   "terminal.integrated.env.linux": {
       "ROS_ENV_SETUP": "1",
       "PYTHONPATH": "${workspaceFolder}/src:${env:PYTHONPATH}"
   },
   "terminal.integrated.profiles.linux": {
       "bash": {
           "path": "bash",
           "args": ["-c", "source path_to/setup.bash && exec bash"]
       }
   },
   "terminal.integrated.defaultProfile.linux": "bash"
   

这种方法的好处是，不管是手动打开终端还是调试自动打开的终端，都会自动加载ROS环境变量。

注意：如果你的setup.bash路径是相对路径，确保VS Code打开的工作区是正确的目录，或者直接使用绝对路径避免出错。

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