[具身智能-714]：colcon build 是 ROS2 官方工具，自动扫描 src 内所有功能包，按依赖顺序编译代码，生成可运行程序；搭配 --symlink-install 适合机器人日常开发

colcon build 完整概述ROS2 专用通俗易懂1. 它是什么colconCollective Construction集合构建工具ROS2 官方标准编译构建系统前身是 ROS1 的catkin_make/catkin build作用一次性编译工作空间内多个 ROS 软件包package。ROS1catkin ROS2colcon2. 核心工作原理在 ROS2 工作空间workspace结构plaintextworkspace_ws └── src/ # 存放所有源码包执行colcon build后自动在 ws 根目录生成 3 个文件夹build/编译中间文件、CMake 缓存install/最终编译产物可执行程序、launch、消息接口log/编译日志排查报错工作流程 扫描src下所有 ROS 包 → 自动分析包之间依赖顺序 → 逐个编译 → 输出到 install 目录。3. 关键特性对比旧版 catkin支持多构建系统同时支持ament_pythonPython 包、CMakeC 包并行编译、依赖自动排序可以选择性编译单个包不用全量编译分离编译产物不容易出现旧文件缓存污染。4. 最重要参数详解bash运行# 基础编译 colcon build # 开发首选--symlink-install 软链接安装 colcon build --symlink-install✅--symlink-install 意义对 Python 脚本、launch 文件、yaml 配置创建软链接。 修改源码里 launch / 脚本不需要重新编译直接生效 C 代码改动依然需要重新编译。bash运行# 只编译指定包提速 colcon build --packages-select 包名 # 清空旧编译文件解决缓存异常 rm -rf build install log5. 编译完成后必须执行bash运行source install/setup.bash作用把install下程序路径导入终端环境让系统能找到你的 ROS2 节点。6. 常见边界认知❌不能在 src 文件夹执行 colcon build必须在 workspace 根目录❌ colcon 不是编译器它是编译调度工具底层依然调用 gcc、cmake、python❌ colcon 不会自动刷新终端环境新开终端都要 source✅ 支持 Humble / Jazzy 所有 ROS2 发行版通用7. 极简总结一句话colcon build是 ROS2 官方工具自动扫描 src 内所有功能包按依赖顺序编译代码生成可运行程序搭配 --symlink-install 适合机器人日常开发调试。