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