這次我們來看一個很經典的 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 輸出但是還沒接觸過通信外設和模擬采樣的同學。貪吃蛇游戲的狀態比較簡單調試