一、认识Marlin固件：Marlin是什么？为什么选择Marlin？
1.1 Marlin到底是什么？
Marlin，说白了就是3D打印机的“大脑”。
你想想看，一台3D打印机，有步进电机、加热棒、温度传感器、限位开关……这些硬件本身不会自己动。谁告诉它们什么时候该转、转多快、加热到多少度？就是Marlin固件。
它是一个运行在主板（通常是AVR或ARM芯片）上的实时控制程序。我习惯把它理解成“硬件驱动+运动控制+G-code解释器”的三合一。你从切片软件导出的G-code文件，每一行指令都由Marlin解析并执行。
举个例子：G1 X100 Y100 Z0.3 F1200 这行代码，Marlin会把它拆解成：
- 目标位置：X轴100mm，Y轴100mm，Z轴0.3mm
- 进给速度：1200mm/min
- 然后通过梯形加减速算法，精确控制每个电机的脉冲时序
我在项目中遇到过不少新手，以为Marlin就是“刷进去就能用”的傻瓜包。其实不然，它更像一套半成品框架——你需要根据自己的机器配置去裁剪、编译、烧录。
1.2 为什么选择Marlin？
市面上3D打印机固件不少，比如RepRapFirmware、Klipper、Smoothieware。但我个人始终推荐Marlin，原因有三：
- 生态最成熟 —— 社区活跃度极高，你遇到的大多数问题，网上都有现成答案。我记得2018年刚入行时，一个Z轴偏移的问题，在Marlin的GitHub Issues里翻到了三年前的讨论，直接解决了。
- 硬件兼容性极广 —— 从8位的Arduino Mega2560到32位的STM32、ESP32，Marlin几乎覆盖了市面上90%的主板方案。你换主板不用换固件体系。
- 功能可裁剪 —— 不需要的功能可以在编译前关掉，节省Flash和RAM。我做过一个极简配置，只保留G-code解析和运动控制，固件体积压缩到80KB，跑在8位芯片上毫无压力。
1.3 版本选择：Bugfix-2.1.x vs 稳定版
嗯，这里要注意。很多新手一上来就问：“我该下哪个版本？” 我直接说结论：
| 版本 | 特点 | 适用场景 |
|---|---|---|
| 稳定版（Release） | 经过完整测试，功能冻结，只修重大bug | 量产机、不想折腾的用户 |
| Bugfix-2.1.x | 每日更新，包含最新功能和修复，但可能引入新bug | 开发调试、需要新特性、愿意承担风险 |
为什么会这样？Marlin的开发模式是：所有新代码先合并到Bugfix分支，经过一段时间验证后，再打Tag发布稳定版。所以Bugfix分支永远比稳定版“新”，但也永远比稳定版“不稳定”。
我曾经踩过一个坑：用Bugfix分支编译后，打印机的BLTouch自动校准功能突然失效了。查了两天，发现是某个提交改了Z探针的逻辑，但没更新对应的配置文件示例。从那以后，我给自己定了个规矩——
我个人习惯的做法是：
- 日常使用：稳定版 + 手动打必要的补丁
- 开发测试：Bugfix分支，但每次更新前先看最近7天的commit记录
- 生产环境：稳定版，绝不碰Bugfix
1.4 知识体系总览
下面这张图，是我自己整理的第一章知识结构。你可以把它当作整个课程的“地图”：
1.5 关于版本号，再说两句
Marlin的版本号遵循语义化版本规范：主版本.次版本.补丁。比如2.1.2，2是主版本，1是次版本，2是补丁号。
但Bugfix分支的版本号比较特殊——它会在稳定版号后面加一个日期戳。比如你从GitHub拉下来的Bugfix-2.1.x，编译时生成的固件版本可能是 2.1.2-bugfix-20250315。这个日期戳能帮你快速定位代码的更新时间点。
好了，第一章的内容就到这里。记住：Marlin是框架，不是成品；稳定版是朋友，Bugfix是玩具。选对版本，你的烧录之路就成功了一半。