目錄一、前置必備環(huán)境初始化必做1. 系統(tǒng)ROS2基礎(chǔ)環(huán)境2. 自定義工作空間環(huán)境二、核心一ros2 run 啟動(dòng)單個(gè)節(jié)點(diǎn)1. 標(biāo)準(zhǔn)語法2. 實(shí)操示例官方海龜模擬器3. 輔助查詢命令解決找不到文件問題三、核心二ros2 launch 啟動(dòng)多節(jié)點(diǎn)程序1. 標(biāo)準(zhǔn)語法2. 實(shí)操示例四、自定義功能包啟動(dòng)完整流程1. 編譯自定義功能包2. 加載編譯后的環(huán)境3. 命令行啟動(dòng)程序五、ROS2 CMake 工具核心使用編譯底層核心1. CMake 在 ROS2 中的作用2. 原生 CMake 手動(dòng)編譯流程理解底層3. ROS2 標(biāo)準(zhǔn) CMakeLists.txt 核心配置解析4. CMake 高頻使用場(chǎng)景與技巧5. CMake 常見編譯報(bào)錯(cuò)避坑六、配套調(diào)試命令開發(fā)必備七、核心區(qū)別總結(jié)新手必記八、常見報(bào)錯(cuò)避坑結(jié)語對(duì)于剛?cè)腴T ROS 2 的開發(fā)者來說通過命令行啟動(dòng)程序是最基礎(chǔ)、最核心的操作。不同于 ROS 1ROS 2 優(yōu)化了命令行語法將單節(jié)點(diǎn)啟動(dòng)、多節(jié)點(diǎn)批量啟動(dòng)做了明確拆分邏輯更清晰但也容易讓新手混淆ros2 run和ros2 launch的使用場(chǎng)景。本文將從零講解 ROS 2 命令行啟動(dòng)程序的兩種核心方式搭配通用實(shí)操命令、場(chǎng)景區(qū)分、配套調(diào)試工具和自定義包啟動(dòng)流程適配 Humble、Iron、Jazzy 全版本 ROS 2新手看完即可上手實(shí)操。一、前置必備環(huán)境初始化必做ROS 2 所有命令行操作的前提是加載環(huán)境變量否則終端會(huì)提示「找不到命令、找不到功能包」等報(bào)錯(cuò)這是新手最高頻的踩坑點(diǎn)。1. 系統(tǒng)ROS2基礎(chǔ)環(huán)境每次新開終端執(zhí)行對(duì)應(yīng)版本的環(huán)境加載命令以最常用的 Humble 為例source /opt/ros/humble/setup.bash2. 自定義工作空間環(huán)境如果是自己創(chuàng)建的工作空間如 ros2_ws編譯程序后需要額外加載工作空間環(huán)境source ~/ros2_ws/install/setup.bash小技巧可以將上述命令寫入~/.bashrc實(shí)現(xiàn)開機(jī)自動(dòng)加載無需每次手動(dòng)執(zhí)行。二、核心一ros2 run 啟動(dòng)單個(gè)節(jié)點(diǎn)ros2 run是 ROS 2 啟動(dòng)單個(gè)獨(dú)立節(jié)點(diǎn)的專屬命令適用于只需要運(yùn)行某一個(gè)功能模塊的簡(jiǎn)單場(chǎng)景是最基礎(chǔ)的啟動(dòng)方式。1. 標(biāo)準(zhǔn)語法ros2 run 功能包名 可執(zhí)行文件名功能包名ROS 2 項(xiàng)目的最小單元文件夾名稱可執(zhí)行文件名功能包編譯后生成的可執(zhí)行程序名稱非文件夾名2. 實(shí)操示例官方海龜模擬器# 啟動(dòng)海龜仿真節(jié)點(diǎn) ros2 run turtlesim turtlesim_node執(zhí)行命令后會(huì)彈出海龜仿真窗口代表單個(gè)節(jié)點(diǎn)啟動(dòng)成功。新開終端輸入下方命令可單獨(dú)啟動(dòng)鍵盤控制節(jié)點(diǎn)ros2 run turtlesim turtle_teleop_key3. 輔助查詢命令解決找不到文件問題新手常不知道功能包的可執(zhí)行文件名稱可通過以下命令查詢# 列出指定包內(nèi)所有可執(zhí)行程序 ros2 pkg executables turtlesim # 查看功能包的安裝路徑 ros2 pkg prefix turtlesim三、核心二ros2 launch 啟動(dòng)多節(jié)點(diǎn)程序?qū)嶋H開發(fā)中一個(gè)機(jī)器人功能往往需要多個(gè)節(jié)點(diǎn)協(xié)同工作如雷達(dá)節(jié)點(diǎn)定位節(jié)點(diǎn)導(dǎo)航節(jié)點(diǎn)逐個(gè)用ros2 run啟動(dòng)效率極低此時(shí)就需要ros2 launch。ros2 launch通過讀取 launch 啟動(dòng)文件可一次性批量啟動(dòng)多個(gè)節(jié)點(diǎn)、配置參數(shù)、設(shè)置設(shè)備別名是項(xiàng)目開發(fā)的主流啟動(dòng)方式。1. 標(biāo)準(zhǔn)語法ros2 launch 功能包名 launch啟動(dòng)文件ROS 2 主流啟動(dòng)文件為.py格式Python兼容少量老舊.xml格式文件。2. 實(shí)操示例# 一鍵啟動(dòng)海龜仿真全套程序 ros2 launch turtlesim turtlesim.launch.py單條命令即可完成多模塊初始化無需逐個(gè)啟動(dòng)節(jié)點(diǎn)大幅提升開發(fā)效率。四、自定義功能包啟動(dòng)完整流程除了官方示例我們自己編寫的 ROS 2 程序可按照「編譯-加載環(huán)境-啟動(dòng)」三步完成啟動(dòng)流程固定通用1. 編譯自定義功能包# 進(jìn)入工作空間 cd ~/ros2_ws # 編譯指定功能包 colcon build --packages-select 你的包名2. 加載編譯后的環(huán)境source install/setup.bash3. 命令行啟動(dòng)程序# 啟動(dòng)單個(gè)自定義節(jié)點(diǎn) ros2 run 你的包名 可執(zhí)行文件名 # 啟動(dòng)自定義launch多節(jié)點(diǎn)程序 ros2 launch 你的包名 啟動(dòng)文件.py五、ROS2 CMake 工具核心使用編譯底層核心前文使用的colcon build是 ROS2 封裝的批量構(gòu)建工具其底層完全依賴 CMake實(shí)現(xiàn)源碼編譯、依賴配置、可執(zhí)行文件生成。對(duì)于自定義 C 功能包必須掌握基礎(chǔ) CMake 用法才能解決編譯報(bào)錯(cuò)、自定義編譯規(guī)則、配置第三方依賴等問題是進(jìn)階開發(fā)的核心技能。1. CMake 在 ROS2 中的作用ROS2 功能包通過根目錄的CMakeLists.txt文件定義編譯規(guī)則CMake 的核心作用掃描源碼、解析依賴、生成編譯配置文件、編譯生成可執(zhí)行節(jié)點(diǎn)/庫(kù)文件最終供ros2 run調(diào)用運(yùn)行。Python 包無需 CMake僅 C 功能包必備。2. 原生 CMake 手動(dòng)編譯流程理解底層日常開發(fā)用 colcon 批量編譯但排查編譯報(bào)錯(cuò)、自定義編譯參數(shù)時(shí)需要掌握原生 CMake 編譯三步流程適配所有 ROS2 C 包# 1. 進(jìn)入功能包編譯目錄ROS2 固定編譯目錄 build cd ~/ros2_ws/build/你的包名 # 2. CMake 生成編譯配置加載ROS2環(huán)境、解析CMakeLists規(guī)則 cmake .. # 3. 執(zhí)行編譯生成可執(zhí)行文件 make -j8參數(shù)說明-j8代表8線程編譯可根據(jù)電腦CPU核心數(shù)調(diào)整加速編譯速度。編譯完成后可執(zhí)行文件會(huì)自動(dòng)生成在install/你的包名/bin/目錄下。3. ROS2 標(biāo)準(zhǔn) CMakeLists.txt 核心配置解析新手無需手寫完整配置只需掌握核心固定字段看懂、會(huì)修改即可適配所有自定義C節(jié)點(diǎn)# 1. 指定CMake最低版本ROS2 Humble及以上推薦3.8 cmake_minimum_required(VERSION 3.8) # 2. 定義功能包名稱必須和package.xml包名一致 project(your_package_name) # 3. 查找ROS2核心依賴必配 find_package(ament_cmake REQUIRED) find_package(rclcpp REQUIRED) # C節(jié)點(diǎn)核心依賴 # 4. 編譯可執(zhí)行節(jié)點(diǎn)源碼文件 生成的節(jié)點(diǎn)名 add_executable(your_node src/your_node.cpp) # 5. 綁定節(jié)點(diǎn)依賴庫(kù) ament_target_dependencies(your_node rclcpp) # 6. 安裝節(jié)點(diǎn)到系統(tǒng)目錄關(guān)鍵否則ros2 run找不到節(jié)點(diǎn) install(TARGETS your_node DESTINATION lib/${PROJECT_NAME} ) ament_package()4. CMake 高頻使用場(chǎng)景與技巧清理舊編譯緩存修改CMakeLists.txt后必須清理緩存否則配置不生效執(zhí)行rm -rf ~/ros2_ws/build ~/ros2_ws/install后重新編譯指定C編譯標(biāo)準(zhǔn)添加set(CMAKE_CXX_STANDARD 17)適配ROS2新版本語法特性添加第三方庫(kù)通過find_package(XXX REQUIRED)引入OpenCV、PCL等第三方依賴5. CMake 常見編譯報(bào)錯(cuò)避坑報(bào)錯(cuò)No CMAKE_CXX_COMPILER未安裝編譯工具執(zhí)行sudo apt install build-essential cmake安裝依賴報(bào)錯(cuò)ament_cmake not found未source ROS2環(huán)境編譯前必須加載系統(tǒng)環(huán)境變量編譯成功但找不到節(jié)點(diǎn)CMakeLists中未配置install安裝規(guī)則節(jié)點(diǎn)未部署到運(yùn)行目錄六、配套調(diào)試命令開發(fā)必備啟動(dòng)程序后可通過以下命令查看節(jié)點(diǎn)狀態(tài)、排查異常適配日常調(diào)試場(chǎng)景# 查看當(dāng)前所有運(yùn)行的節(jié)點(diǎn) ros2 node list # 查看指定節(jié)點(diǎn)的詳細(xì)信息話題、服務(wù)、參數(shù) ros2 node info /節(jié)點(diǎn)名七、核心區(qū)別總結(jié)新手必記啟動(dòng)命令適用場(chǎng)景核心特點(diǎn)ros2 run單個(gè)節(jié)點(diǎn)啟動(dòng)、單點(diǎn)調(diào)試簡(jiǎn)單直接僅啟動(dòng)一個(gè)可執(zhí)行程序無批量配置能力ros2 launch多節(jié)點(diǎn)聯(lián)動(dòng)、項(xiàng)目整體啟動(dòng)支持批量啟動(dòng)、參數(shù)配置、節(jié)點(diǎn)管理適合正式開發(fā)八、常見報(bào)錯(cuò)避坑報(bào)錯(cuò)Package not found未加載環(huán)境變量重新執(zhí)行source環(huán)境命令即可報(bào)錯(cuò)Executable not found功能包未編譯、可執(zhí)行文件名輸入錯(cuò)誤節(jié)點(diǎn)啟動(dòng)無反應(yīng)終端未加載工作空間環(huán)境編譯后必須重新 source結(jié)語命令行啟動(dòng)是 ROS 2 開發(fā)的入門基石熟練區(qū)分ros2 run和ros2 launch的使用場(chǎng)景能快速適配單點(diǎn)調(diào)試和項(xiàng)目部署場(chǎng)景。后續(xù)復(fù)雜的機(jī)器人導(dǎo)航、建圖、視覺項(xiàng)目均基于這兩種啟動(dòng)方式延伸。建議新手多實(shí)操練習(xí)結(jié)合節(jié)點(diǎn)查詢、狀態(tài)調(diào)試命令徹底吃透基礎(chǔ)用法為后續(xù)進(jìn)階開發(fā)打好基礎(chǔ)。