如何使用Dockerfile构建ROS Noetic并在容器内编译ROS package

镜像体积优化 #

• 采用多阶段构建：同一份Dockerfile拆分两个阶段，第一阶段使用完整的ROS Noetic开发镜像安装编译依赖、编译ROS包，第二阶段仅拷贝第一阶段编译完成的安装文件和必要的运行时依赖，可砍掉一半以上镜像体积，同时避免构建中间文件、源码残留到最终镜像。
• 合并RUN指令并清理缓存：将apt update、依赖安装、缓存清理合并到同一条RUN指令中，安装完成后立即执行apt clean && rm -rf /var/lib/apt/lists/*，避免产生多余镜像层，也不会残留apt缓存占用空间。
• 安装依赖时跳过非必要项：执行apt install时添加--no-install-recommends参数，跳过文档、测试工具、可选依赖等非运行必需的包，大幅缩减依赖体积。

编译流程正确性&效率优化 #

• 提前处理ROS环境变量：编译指令使用bash执行并主动source ROS环境，避免默认sh不支持source、环境变量未加载导致的编译报错，示例写法：RUN /bin/bash -c 'source /opt/ros/noetic/setup.bash && cd <工作区路径> && catkin_make'，也可提前将source指令写入~/.bashrc简化后续操作。
• 分层缓存依赖：先拷贝ROS包的package.xml到工作区，执行rosdep install安装所有依赖，再拷贝完整的包源码，只要package.xml没有改动，Docker就会复用依赖安装层的缓存，不用每次修改代码都重新安装依赖，示例流程：

# 先拷贝包配置文件
COPY ./your_ros_package/package.xml /root/catkin_ws/src/your_ros_package/
# 安装所有依赖
RUN rosdep install --from-paths /root/catkin_ws/src --ignore-src -r -y
# 再拷贝完整源码
COPY ./your_ros_package /root/catkin_ws/src/your_ros_package/
# 编译
RUN /bin/bash -c 'source /opt/ros/noetic/setup.bash && cd /root/catkin_ws && catkin_make install -j$(nproc)'

• 编译时开启并行加速：catkin_make添加-j$(nproc)参数，自动匹配CPU核心数开启并行编译，大幅提升编译速度。

可维护性优化 #

• 固定基础镜像标签：不要使用ros:noetic这类浮动标签，选择明确的版本标签例如ros:noetic-robot-focal，避免基础镜像后续更新带来的兼容性问题。
• 用WORKDIR固定工作路径：不要在RUN指令中频繁切换路径，用WORKDIR指定默认工作区，减少路径写错的概率。
• 禁止硬编码敏感信息：所有密钥、本地配置都通过容器启动时的环境变量、挂载卷传入，不要写死到Dockerfile中。

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