这次我们来看一个很经典的 STM32 入门综合实战STM32F103C8T6 最小系统板搭配 0.96 寸 I2C OLED 显示屏加上双轴摇杆在单片机上实现贪吃蛇游戏。项目不依赖上位机不走串口绘图显示、输入、逻辑全部由 STM32 自己完成非常适合把 HAL 库的 I2C 外设、ADC 外设和状态机设计串起来练一遍。先说结论STM32F103C8T6 驱动 OLED 做贪吃蛇完全没有性能压力。OLED 用 I2C 只需要 PB6/PB7 两根线摇杆用 ADC 只需要 PA0/PA1 两个模拟输入128×64 的显示分辨率切分成 16×8 个单元格游戏逻辑主要靠一个固定间隔的移动定时器驱动。整个工程推荐用 STM32CubeMX 生成骨架 HAL 库写外设驱动IDE 选 Keil MDK 或 STM32CubeIDE 都行。本文会依次讲清楚硬件接线、CubeMX 配置、OLED 驱动代码、摇杆 ADC 采样、贪吃蛇核心逻辑、主循环刷新控制、测试方法和常见问题。代码会给出完整版本你可以直接复制到自己的工程里跑通。1. 项目核心能力速览能力项说明主控芯片STM32F103C8T6Cortex-M3 内核72MHz64KB Flash20KB SRAM显示方案0.96 寸 I2C OLEDSSD1306128×64I2C1 接口速率 400kHz输入方案双轴摇杆模块ADC1 采样PA0 接 X 轴PA1 接 Y 轴游戏机制经典贪吃蛇墙碰检测、自碰检测、随机食物生成、分数统计工程形态STM32CubeMX 生成工程 HAL 库驱动Keil MDK / STM32CubeIDE 均可编译启动方式上电自动运行无上位机依赖调试方式ST-Link SWD 下载调试串口可选输出调试日志可扩展性支持增加难度加速、最高分保存、LCD 屏适配、FreeRTOS 任务化重构从功能清单可以看出这个项目的核心不是游戏本身而是把单片机常见外设串起来用I2C 屏要解决“怎么画点、怎么刷新”ADC 要解决“摇杆读数怎么映射成方向”主循环要解决“什么时候让蛇动一次”。这三个问题一旦跑通后面再去做温湿度显示、遥控小车、菜单系统思路是完全共通的。需要特别说明的是STM32F103C8T6 的 20KB SRAM 对 1024 字节的 OLED 帧缓冲区来说很宽裕即使加字库、加游戏状态数组也不会出现内存紧张的情况。Flash 64KB 对 HAL 库驱动来说也够用正常工程编译出来一般在 20KB 到 30KB 之间留有余量。2. 适用场景与使用边界这个项目最合适的读者是已经学会点灯、懂 GPIO 输出但是还没接触过通信外设和模拟采样的同学。贪吃蛇游戏的状态比较简单调试