树莓派机器人从入门到进阶：避障小车、四足/人形/乒乓/扫地/斗牛八大项目实战指南

树莓派凭借 **Linux 完整软件栈、GPIO/USB/CSI/DSI 丰富外设、Python/C++/ROS 生态、极高性价比**，成为 Maker、教育、科研、原型验证首选机器人大脑。本文从零开始，手把手带你搭建 **超声波/红外避障入门小车**，再推荐 **CHOP 四足、乒乓球机器人、人形机器人、Pi Roomba 扫地、黄油机器人、Petoi 机械猫、Spot Micro 四足、微型斗牛、Devastator 履带** 九大进阶项目，覆盖运动学、视觉、SLAM、强化学习、远程操作全技术栈。

入门项目：红外避障小车 (30 分钟上手)

硬件清单 (约 ¥200)

• 树莓派 3B/3B+/4B (任意)
• L298N / L293D 双 H 桥驱动板
• TT 减速电机 ×2 + 万向轮 ×1
• 红外避障模块 (FC-51) ×2 (左/前)
• 7.4 V/11.1 V 锂电池 + 5V 降压模块 (LM2596/XY-3606) 供电 Pi
• 底盘套装 (亚克力/铝合金)
• 杜邦线、螺丝刀、热熔胶

接线要点 (BCM 编号)

Python 避障核心逻辑 (gpiozero 库)

from gpiozero import Robot, DistanceSensor
from signal import pause

robot = Robot(left=(5,6), right=(19,26), pwm_pins=(12,13))
ir_left = DistanceSensor(echo=16, trigger=16, max_distance=0.3, threshold_distance=0.15)  # FC-51 仅数字量, 简化用法
ir_front = DistanceSensor(echo=20, trigger=20, max_distance=0.3, threshold_distance=0.15)

def avoid():
    if ir_front.distance < 0.15:
        robot.backward(0.5); sleep(0.3); robot.right(0.5); sleep(0.4)
    elif ir_left.distance < 0.15:
        robot.right(0.5); sleep(0.3)
    else:
        robot.forward(0.5)

# 主循环
while True:
    avoid()
    sleep(0.05)

进阶**：改用 `gpiozero.Motor` + PID 速度闭环、加装编码器实现里程计、接入 ROS 2 `diff_drive_controller`。

进阶项目图谱 (按技术深度排序)

通用软件架构建议 (ROS 2 Humble/Iron)

graph TD
    A[传感器驱动节点] --> B[感知融合节点]
    B --> C[局部/全局规划器]
    C --> D[控制器]
    D --> E[执行器驱动]
    F[远程操作/手柄] --> C
    G[任务调度/行为树] --> C

• 驱动层：`ros2_control` + `hardware_interface` 统一电机/舵机/传感器抽象。
• 感知层：`depthai` (OAK-D), `ros2_ouster` (激光), `v4l2_camera` (CSI/USB), `imu_filter_madgwick` (IMU)。
• 规划层：`Nav2` (BT Navigator, DWB/MPPI Controller, Smac Planner)。
• 仿真先行**：Gazebo/Ignition + URDF/Xacro 建模 → 仿真验证 → 实机部署，避免撞坏硬件。

避坑指南 Top 10

1. 供电分离：电机/舵机大电流**绝不**走 Pi 5V/GND，独立 BEC/降压模块，共地即可。
2. PWM 引脚冲突：Pi 仅两路硬件 PWM (GPIO12/13, 18/19)，多舵机必须外挂 PCA9685 (I²C 16 路) / STM32 从机。
3. CSI 摄像头带宽：Pi 4B 双 CSI 但共享 1.5 Gbps MIPI 总线，双 1080p30 会掉帧，单路 4K30 或 双路 720p60 稳妥。
4. SD 卡寿命：高频写入 (日志/rosbag) 易损坏，`/var/log` `tmpfs` 挂载内存 + 定期 `logrotate` + 高耐久 A2 卡 / USB SSD 启动。
5. 散热：Pi 4B 满载 6–7 W，**必须**主动散热 (风扇/金属外壳)，否则 2 分钟降频至 1.0 GHz。
6. 实时性**：标准 Linux 非硬实时，控制环 > 1 kHz 需 `PREEMPT_RT` 内核或外挂 MCU (STM32/ESP32) 做底层环路。
7. 版本锁定**：`requirements.txt` / `rosdep` 固定依赖版本，避免 `apt upgrade` 破坏 ROS 环境。
8. 机械公差**：3D 打印件缩孔/翘边导致卡滞，设计留 0.2–0.3 mm 配合间隙，关键轴孔钻/铰修正。
9. 线缆管理**：拖链/理线架/航空插头防疲劳断线，舵机线加信号放大/差分驱动 (RS-485) 超 1 m。
10. 安全回退**：硬件看门狗 (Pi 内置 `dtparam=watchdog=on`) + 软件心跳 + 急停物理按钮切断电机电源。

结语

树莓派机器人之路：**入门避障车验证 GPIO/PWM/传感器闭环 → 进阶 ROS 2 全栈导航/视觉/运动学 → 专项深耕 (四足步态、视觉伺服、SLAM、边缘 AI)**。硬件上 **Pi 4B/5 + PCA9685 + 独立供电 + 主动散热** 是通用最优基座；软件上 **ROS 2 + 仿真先行 + 版本锁定 + 安全回退** 是工程化铁律。无论你是学生、教师、极客还是原型验证工程师，这条路径都能让你以可控成本、可复现步骤、可迁移经验完成从 0 到 1 的机器人交付。完整 BOM 表、URDF 模型、ROS 2 Launch 文件、仿真世界包、3D 打印 STL、PCB 电源板原理图欢迎联系获取。