如何在Windows WSL环境下配置CLion以开发ROS2包？

从你提供的配置截图来看，问题大概率出在CMake环境变量未正确加载ROS2的环境配置，或是工具链未指定为WSL环境。以下是完整的正确配置步骤：

一、前置准备 #

• 确保WSL中已完成ROS2的正常安装（如Humble、Iron等版本），在WSL终端能正常执行colcon build、ros2 run等命令
• 确认CLion已安装WSL插件（默认自带，可在Settings -> Plugins中验证）

二、CLion核心配置 #

1. 导入ROS2工作空间 #

打开CLion，选择Open，通过WSL文件系统导航到你的ROS2工作空间（例如~/ros2_ws），直接打开该文件夹。

2. 配置WSL工具链 #

• 进入Settings -> Build, Execution, Deployment -> Toolchains
• 点击+选择WSL，系统会自动检测WSL内的GCC、CMake等工具，确认路径无误（如GCC路径为/usr/bin/gcc，CMake路径为/usr/bin/cmake）
• 将该WSL工具链设为默认选项

3. 配置CMake Profiles（关键） #

• 进入Settings -> Build, Execution, Deployment -> CMake
• 在Profiles栏点击+新建配置，命名为ROS2 WSL
• Toolchain选择刚才配置的WSL工具链
• 在CMake options中添加ROS2版本标识，以Humble为例：

  -DCMAKE_BUILD_TYPE=Release -DROS_DISTRO=humble
  

• 在Environment区域点击...，选择Load from file，导航到WSL中ROS2的setup脚本（如/opt/ros/humble/setup.bash）；若已构建工作空间，也可加载~/ros2_ws/install/setup.bash（建议先加载系统ROS2脚本，再加载工作空间的）
  • 也可手动添加核心环境变量：

    ROS_DISTRO=humble
    ROS_ROOT=/opt/ros/humble
    PATH=/opt/ros/humble/bin:$PATH
    LD_LIBRARY_PATH=/opt/ros/humble/lib:$LD_LIBRARY_PATH
    

4. 配置内置终端 #

• 进入Settings -> Tools -> Terminal
• 将Shell path设置为C:\Windows\System32\wsl.exe，这样CLion终端会直接进入WSL环境，方便执行ROS2命令

三、构建与验证 #

• 返回CLion主界面，点击Reload CMake Project，等待CMake加载完成
• 选择ROS2 WSL配置文件，点击Build，正常情况下可完成ROS2包的编译
• 运行节点时，可通过CLion的Run/Debug Configurations创建ROS Node配置，选择对应包和节点；也可直接在终端执行ros2 run命令

四、常见问题排查 #

• 若CMake加载失败，检查是否正确加载了ROS2的setup脚本，可在WSL终端先执行source /opt/ros/humble/setup.bash，再启动CLion
• 若编译报错，确认WSL中已安装ROS2依赖包，如ros-humble-colcon-common-extensions
• 建议使用最新版本的CLion，以获得更好的WSL与ROS2兼容性

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