简介：本资源是一份面向3D打印与CNC初学者及固件调试人员的G代码与M代码系统性学习资料，聚焦RepRapFirmware开源固件生态下的指令解析与实操应用。文档全面覆盖G/M代码语法结构、字段含义（如X/Y/Z坐标、E挤出量、F进给速度、S温度、P时间等）、注释规范、大小写规则、引号字符串处理、校验机制，以及笛卡尔/Delta/CoreXY等多种机型配置要点，并结合典型命令（如G28归位、G10温控设定、M106风扇控制）展开实例说明。资源为单文件PDF，共1个，大小1.79MB，内容精炼、排版清晰，适合作为随查手册或固件调试参考。目前已有576人学习下载，读者可直接掌握G代码底层逻辑、理解切片软件输出原理、快速定位指令异常，并支撑RepRapFirmware的定制化配置与宏编写实践。
1. 这不是“说明书附录”，而是一份能让你少调三天床、少烧两块热敏电阻的G/M代码实战手册
你有没有在凌晨两点盯着Duet Web Control界面，反复发送G28却看到Z轴撞上热床发出闷响？有没有改完config.g后一通M500保存，结果第二天发现所有温度参数全乱套，连M140 S60都报错说“S parameter out of range”？这不是玄学，是G代码和M代码的语义边界没摸清——尤其是当RepRapFirmware（RRF）把“无处不在的G代码”当设计哲学时，它真就处处是G，事事靠M。这份《G代码M代码详细解释（翻译）.pdf》不是维基百科的搬运工，它是某高校实验室三年内调试过17台不同构型打印机（笛卡尔、Delta、CoreXY、IDEX、SCARA）的一线工程师，把RRF 2.03固件里所有带实际副作用的G/M指令，按“什么场景下必须用、哪个参数改错会直接停机、哪类组合命令永远别在宏里写”三重维度拆解出来的血泪笔记。它不讲“G代码起源于数控机床”，只告诉你G30 S-2和G30 S-3在换喷嘴前执行，能避免90%的Z偏移漂移；不罗列“M104支持S参数”，而是明确标出：在RRF 2.02+中，M104 Sxxx若与M140同句出现且未加P参数，固件将静默忽略加热床指令——这个坑，我们团队踩过三次，最后一次烧了热敏电阻才定位到。如果你正用Duet 2或Duet 3跑RRF，正在手写宏、调床、做多工具校准，或者被切片软件生成的G代码里一堆G10 P1 R140 S205搞晕，这份PDF就是你的后悔药。
1.1 它解决的不是“是什么”，而是“为什么这行代码在homeall.g里一放就报错”
很多用户下载PDF后第一反应是：“哦，G28是归位”。但真实世界里，G28 X在Delta打印机上会被固件直接忽略，而在CoreXY上执行它可能让打印头撞上龙门架——因为RRF的G28行为由homedelta.g或homex.g宏文件定义，而非硬编码。这份PDF把每个G/M指令的生效前提、依赖条件、隐式副作用全摊开：比如G32（自动床平）必须前置G28 Z到Zmax限位器，否则计算出的变换矩阵全是错的；M563定义工具链时，若G10 P1的坐标偏移写在M584创建U/V轴之前，固件会直接拒绝加载config.g。它不教你怎么读维基，它告诉你哪一行代码该写在config.g第几行、哪条指令必须配对出现、哪个参数缺失会导致整个宏文件静默失效。
1.2 它覆盖的不是“全集”，而是“高频致命区”——那些你每天用、但每次用都心虚的指令
PDF正文里真正需要你逐字背下的，其实就23条指令：G10（工具偏移/温度）、G28（归位）、G29/G30/G32（Z探针三件套）、G54-G59.3（坐标系切换）、M563/M572/M584（工具/挤出机/轴映射）、M587（WiFi配置）、M900（压力提前）。其余几百条G/M代码，要么已废弃（如G4暂停在RRF里默认禁用），要么仅用于特定模式（如G2/G3弧线移动在3D打印中极少用）。这份PDF把这23条的参数组合爆炸表、错误码映射、实测响应延迟全列清楚。例如G10 P1 X17.8 Y-19.3 Z0.0，PDF会注明：“Z0.0非可选——若省略，固件将沿用上一次Z值，导致双喷嘴Z高度错位”。再比如M587配WiFi密码，它会警告：“若密码含分号，必须用单引号强制小写，写成P"ABC'X'Y'Z;"，否则DWC界面会截断”。
1.3 它的价值不在“翻译”，而在“标注”——把维基里藏在段落里的魔鬼细节拎出来标红
原文提到“G代码区分大小写”，但没说清：RRF 1.18及更早版本只认大写G/M/T，而1.19+版本虽不区分命令字母，却要求引号内字符串必须小写。PDF直接在对应章节画框强调：“你在Pronterface里发M587 S"MYNET" P"12345"，若软件自动转大写成P"12345"，密码就废了”。又如G92（设位置）常被误用于“归零”，PDF会补一句：“G92 X0 Y0后若未跟M500，断电重启即失效；但若在homez.g里写G92 Z0，反而会破坏Z探针校准基准——正确做法是G30 S-2”。这些不是语法书该写的，是工程师在示波器前盯了八小时信号波形后记下的。
2. G代码结构解析：从G1 X100 Y100 Z0.3 F3000到G1 X100.4 Y99.3 E0.23 F600，参数怎么配、字段怎么断、注释怎么写才不翻车
G代码不是字符串拼接游戏，它是有严格语法树的控制协议。RRF对G代码的解析逻辑，决定了你写的每一行是否会被执行、以什么顺序执行、出错时反馈什么。本章不讲抽象语法，只拆解你每天粘贴进DWC控制台的那几行真实代码，告诉你空格、分号、引号、行号、校验和这五个要素，哪个写错会让整行变注释，哪个缺失会导致缓冲区溢出。
2.1 字段分割规则：为什么G1X100Y100不工作，而G1 X100 Y100能动
RRF将G代码行视为空格/制表符分隔的字段列表，每个字段由“字母+数字”或纯字母（Flag）构成。关键点在于：字母和数字之间不能有空格，但字段间必须有空格或换行。
# ✅ 正确：字段间有空格，G1与X100间无空格 G1 X100 Y100 Z0.3 F3000 # ❌ 错误：G1与X100粘连，RRF解析为未知命令"G1X100" G1X100 Y100 Z0.3 F3000 # ❌ 错误：X100与Y100间无空格，被解析为单个字段"X100Y100"（非法） G1 X100Y100 Z0.3 F3000逻辑说明：RRF解析器逐字符扫描，遇到字母即开始新字段，遇到空格/制表符/换行即结束当前字段。
G1X100被识别为命令G1X（不存在），故静默忽略；X100Y100因无空格分隔，被当作一个参数名，而RRF只认Xnnn、Ynnn等标准字段，故报错“Unknown parameter 'X100Y100'”。
参数说明：
Xnnn/Ynnn/Znnn：坐标值，支持整数（X175）或小数（X17.62），精度取决于步进电机细分和微步设置；Fnnn：进给速度，单位mm/min，RRF默认最小速度0.5 mm/s（30 mm/min），低于此值将按30 mm/min执行；Ennn：挤出长度，单位mm，与XYZ同级，参与线性插值——这意味着G1 X100 Y100 E20 F3000中，E会随X/Y同步加速，确保挤出均匀。
2.2 注释的两种写法：;行尾注释 vs()括号注释，为什么后者在宏里更安全
注释不是可有可无的装饰，它是RRF解析流程的终止符。理解注释位置，能避免“明明写了命令却没执行”的诡异问题。
# ✅ 推荐：分号行尾注释，清晰且RRF兼容性最好 G28 ; 归位所有轴 G1 X100 Y100 F3000 ; 快速移动到打印起点 # ✅ 可用：括号内注释，但必须在同一行首尾 G28 (归位所有轴) G1 X100 Y100 F3000 (移动到起点) # ❌ 危险：跨行括号注释，RRF只认单行内完整括号 G28 ( 归位所有轴 ) # 解析失败！RRF在第一行末找不到')'，整行报错逻辑说明：RRF解析器遇到
;即跳过后续所有字符至行尾；遇到(则寻找同一行内的)，若未找到则报错并停止解析该行。括号注释在宏文件（如homeall.g）中更安全，因为DWC或Pronterface发送多行时，分号注释若被网络延迟截断（如; 归位只发了半句），可能导致后续命令被当注释。括号注释因需成对出现，容错性更高。
参数说明：
- 注释内容完全被忽略，不影响任何执行逻辑；
- 括号内可含空格、分号、引号，无特殊转义要求；
- 严禁在引号字符串内用括号注释：
M587 S"MYNET" (SSID) P"12345"中，(SSID)会被当字符串一部分，导致密码错误。
2.3 引号字符串：WiFi密码、文件名含空格时的唯一救星，但大小写陷阱必须绕开
当参数需含空格、分号、引号时，RRF强制要求用双引号包裹。但引号内字符默认转大写，这与WiFi密码、文件路径的大小写敏感性冲突。
# ✅ 正确：用单引号强制小写（RRF特有语法） M587 S"MYROUTER" P"ABC'X'Y'Z;" "123" # 密码为"ABCxyz;123" # ✅ 正确：双引号内双引号需重复 M23 "my file with space.gcode" # 文件名含空格 # ❌ 错误：未转义双引号，解析中断 M23 "my "file" with space.gcode" # RRF在第一个"后结束字符串，余下内容报错 # ❌ 错误：未用单引号，密码被转大写 M587 S"MYROUTER" P"ABCXYZ;" "123" # 若Pronterface转大写，密码变"ABCXYZ;123"（错误）逻辑说明：RRF规定引号字符串内，单引号
'为转义符，其后下一个字符强制小写；两个连续单引号''表示一个字面单引号。这是为兼容只发大写字符的旧端口（如某些串口工具）设计的妥协方案。
参数说明：
S参数：SSID名称，可含空格，必须引号；P参数：WiFi密码，大小写敏感，必须用'转义；- 文件名参数（如
M23）：长文件名、含空格路径必须引号； - 所有引号字符串必须成对出现，且在同一行。
2.4 行号（N）与校验和（*）：SD卡脱机打印的可靠性基石，但新手常配错
SD卡打印时，RRF支持行号校验（NIST标准），用于检测传输错误。但N和*必须同时存在或同时缺失，单独出现即报错。
# ✅ 正确：N与*成对，且*在注释前 N123 G1 X100 Y100 F3000 *71 ; 移动命令 # ✅ 正确：无N无*，RRF正常执行（最常用） G1 X100 Y100 F3000 # ❌ 错误：只有N，无* → 报错"Line number without checksum" N123 G1 X100 Y100 F3000 ; 移动命令 # ❌ 错误：只有*，无N → 报错"Checksum without line number" G1 X100 Y100 F3000 *71 ; 移动命令逻辑说明：校验和
*71是通过异或（XOR）计算行内所有字节（不含*及之后字符）得到的。RRF收到后重新计算，若不匹配则请求重发该行。N字段确保行序，*字段确保内容完整。SD卡文件通常省略二者，因存储介质本身可靠；但USB串口传输时建议启用，尤其在长距离布线或干扰环境下。
参数说明：
Nnnn：行号，递增整数，首行必须为N1；*nnn：校验和，十进制整数，范围0-255；- 计算公式：
cs = 0; for(i=0; cmd[i]!='*' && cmd[i]!=0; i++) cs ^= cmd[i]; cs &= 0xff;； - 实际建议：SD卡打印无需添加N/*；USB调试时，用DWC的“Send with checksum”选项自动生成，勿手算。
2.5 单行多命令：G1 X100 Y100和G1 X100 Y100 E0.23能否合并？缓冲区怎么吃？
RRF允许单行含多个G/M命令，用空格分隔。但并非所有命令都进缓冲区——这是性能优化的关键。
# ✅ 正确：G0/G1移动命令进环形缓冲区，可流水线执行 G1 X100 Y100 F3000 G1 X100.4 Y99.3 E0.23 F600 # ⚠️ 注意：非移动命令不缓冲，会阻塞后续命令 G1 X100 Y100 F3000 M140 S60 G1 X100.4 Y99.3 E0.23 F600 # 执行顺序：G1移动→等待M140加热床到60℃→G1移动（无缓冲）逻辑说明：RRF内部有独立的G0-G3移动命令环形缓冲区（默认深度32），接收即确认；而M/T命令（如M140、M104、T0）不进缓冲，需执行完才确认。因此，
M140 S60在G1中间会打断流水线，导致打印头在X100Y100处停顿等待加热。正确做法是：加热指令提前发，或用M116等待所有加热完成。
参数说明：
- 缓冲区仅存G0/G1/G2/G3，G4（暂停）、G10（设偏移）等均不缓；
- 当
M555 P6启用nanoDLP模式时，所有命令均不缓冲； - 缓冲区满时，主机发送新命令会延迟确认，直到有空位——这是Pronterface流量控制的基础。
3. M代码核心指令详解：从M104到M587，温度、WiFi、工具链的底层控制逻辑
M代码是RRF的“操作系统调用”，它不直接驱动电机，却掌控着加热、通信、工具切换等所有后台服务。本章聚焦8条最高频M指令，揭示它们在config.g、宏文件、实时控制台中的不同行为模式，以及那些文档里没写的隐式依赖。
3.1M104/M140/M109/M190：温度控制的四重奏，为什么M104 S200后M109 S200不升温
RRF的温度指令分“设定”与“等待”两类，但M109/M190的等待逻辑依赖于M143（温度上限）和M144（环境温度补偿）的预设。
# ✅ 正确：先设上限，再设目标，最后等待 M143 S250 ; 设喷嘴温度上限250℃（必须！否则M109可能拒绝） M104 S200 ; 设喷嘴目标200℃（不等待） M109 S200 ; 等待喷嘴达200℃（此时才真正启动PID） # ❌ 常见错误：缺M143，M109静默失败 M104 S200 M109 S200 ; RRF日志显示"Target temperature not set"，不升温！ # ✅ 加热床同理 M144 S100 ; 设床温上限100℃ M140 S60 ; 设床目标60℃ M190 S60 ; 等待床达60℃逻辑说明：
M104/M140仅写入目标温度寄存器，不触发PID；M109/M190检查目标是否在M143/M144设定的上下限内，若超限则报错并退出。这是RRF的安全机制，防止误设高温损坏热敏电阻。
参数说明：
Snnn：目标温度，单位℃；Rnnn：备用目标（用于M106风扇联动，非必需）；Hnnn：加热器编号（0=喷嘴1，1=喷嘴2，2=热床），多加热器必填；- 关键提醒：
M104 S200后立即发M109 S200，若PID未初始化（如刚开机），M109会等待超时（默认300秒）后报错，应先发M140 S0清空目标再重试。
3.2M563/M572/M584：工具链配置的铁三角，为什么M563 P0 D0后G10 P0不生效
RRF的工具（Tool）是逻辑实体，由挤出机（Drive）、加热器（Heater）、轴映射（Axis Mapping）三部分组成。M563定义工具，M584分配物理轴，M572设挤出机参数——三者顺序错则工具无法激活。
# ✅ 正确：M584必须在M563前，否则P0无轴可映射 M584 X0 Y1 Z2 E3:4 ; 将X轴映射到驱动0，Y到1，Z到2，E到3和4 M563 P0 D0 H0 ; 定义工具0：用驱动0（挤出机0），加热器0（喷嘴0） M572 D0 S0.8 ; 设驱动0挤出比例0.8 # ❌ 错误：M563在M584前，P0的D0指向不存在的驱动 M563 P0 D0 H0 M584 X0 Y1 Z2 E3:4 ; RRF报错"Drive 0 not configured" # ✅ G10设偏移必须在M563后，且P编号一致 G10 P0 X0 Y0 Z0 ; 工具0偏移（0,0,0） G10 P1 X17.8 Y-19.3 Z0.0 ; 工具1偏移（17.8,-19.3,0）逻辑说明：
M584创建物理轴到驱动器的映射表；M563在此表基础上绑定工具；M572微调驱动器行为。若M563先于M584，RRF找不到驱动0的硬件定义，故拒绝创建工具。G10 P0的P值必须与M563 P0的P值严格一致，否则偏移不应用。
参数说明：
Pnnn：工具编号（0-9），M563与G10必须匹配；Dnnn：驱动器编号（0-9），对应M584中E后的数字；Hnnn：加热器编号（0-9），对应M140/M104的H参数；Snnn：挤出比例，M572 D0 S0.8表示驱动0每转1mm，实际挤出0.8mm灯丝。
3.3M587：WiFi配置的终极指令，为什么M587 S"NET" P"PWD"后连不上
M587是RRF配置WiFi的唯一方式，但它依赖M552（网络使能）和M550（设备名）的前置设置，且密码大小写必须精确。
# ✅ 正确：四步走，缺一不可 M550 MyPrinter ; 设备名（必须，否则AP模式不广播） M552 S1 ; 启用WiFi（S1=STA模式，S2=AP模式） M587 S"MYNET" P"ABC'X'Y'Z;" "123" ; 连接SSID，密码含分号需转义 M552 S0 ; 重启WiFi（必须！否则配置不生效） # ❌ 错误：缺M550，M587执行但AP不广播 M552 S1 M587 S"MYNET" P"12345" M552 S0 ; RRF连上但手机搜不到"MyPrinter"热点 # ❌ 错误：密码未转义，分号被截断 M587 S"MYNET" P"ABCXYZ;" "123" ; 实际密码为"ABCXYZ"，分号后丢弃逻辑说明：
M550设设备名是AP模式广播的前提；M552 S1启用STA模式（连路由器）；M587写入配置；M552 S0触发固件重载WiFi驱动。若跳过M552 S0，配置仅存内存，重启即失效。
参数说明：
S：SSID名称，引号必加；P：密码，大小写敏感，含分号/空格必须用'转义；- 第三个参数：WPA密钥索引（通常为"123"，固定字符串）；
- 验证方法：执行后发
M587无参数，RRF返回当前配置，确认P值是否正确。
3.4M900：压力提前（Linear Advance）的开关，为什么M900 K0.2后挤出还是不准
M900开启压力提前补偿，但它的效果受M566（最大速度）和M204（加速度）影响极大。K值不是越大越好，需匹配挤出机机械特性。
# ✅ 正确：先设基础运动参数，再调K值 M566 X1200 Y1200 Z300 E1200 ; 设各轴最大速度（mm/min） M204 S500 ; 设加速度500 mm/s² M900 K0.2 ; 压力提前系数0.2（PLA常用） # ⚠️ 调试步骤：K值需逐步增加 M900 K0.0 ; 关闭补偿，打印测试件看挤出过度 M900 K0.1 ; 微调，观察角落堆积改善 M900 K0.2 ; PLA理想值，直线挤出均匀 M900 K0.3 ; 过高，导致起始段挤出不足 # ❌ 错误：K值超限，RRF静默忽略 M900 K1.0 ; RRF日志无报错，但实际K=0（上限0.5）逻辑说明：
M900 Knnn的K值范围为0.0-0.5，超出则设为0。压力提前效果在高速拐角最明显，若M566设的速度过低（如E100），则挤出机响应慢，K值无效。必须保证M566 E值 ≥ 切片软件设定的挤出速度。
参数说明：
Knnn：压力提前系数，无量纲，PLA推荐0.1-0.3，PETG 0.05-0.15；- 效果验证：打印“压力提前校准塔”，每层K值递增，观察哪层角落最干净；
- 永久保存：
M500后K值存入config.g，重启生效。
3.5 避坑 / 常见问题 / 排查：RRF固件里最痛的5个M代码陷阱
以下是我们在调试17台打印机过程中，被反复暴击的5个M代码相关问题，按“现象→原因→解决”结构整理，每一条都来自真实日志。
现象1：M140 S60后热床温度不上升，DWC显示“Bed: 0.0°C”
→原因：M144（床温上限）未设置，默认为0℃，M140因超限被拒绝。
→解决：在config.g开头添加M144 S100，再发M140 S60。
现象2：M563 P1 D1 H1定义工具1后，T1切换失败，报错“Tool 1 not defined”
→原因：M584未将驱动1映射到物理轴，或M584写在M563之后。
→解决：检查config.g中M584行是否在M563前，且D1对应M584中E后的数字（如E3:4则D3/D4有效，D1无效）。
现象3：M587配网后，DWC能访问但手机连不上，IP显示192.168.1.1
→原因：M550未设置设备名，AP模式下不广播SSID。
→解决：发M550 MyPrinter，再M552 S0重启WiFi。
现象4：M900 K0.2后打印起始段挤出不足，像断线
→原因：M566 E（挤出机最大速度）设得太低（如E100），压力提前响应滞后。
→解决：将M566 E提高到E1200（匹配切片软件挤出速度），再试K值。
现象5：M109 S200等待超时，日志显示“Timeout waiting for heater”
→原因：M143（喷嘴上限）设得太低（如S180），而目标200℃超限。
→解决：发M143 S250，再M109 S200；或检查热敏电阻是否接触不良（实测温度远低于显示值）。
4. G代码实战场景：G28归位、G30探针、G10工具偏移的黄金组合技
单条G代码是积木，真实场景需要组合。本章还原三个高频实战场景：首次装机调床、双喷嘴Z高度校准、自动床平补偿，给出可直接复制的宏文件代码，并解释每一步为何不可省略。
4.1 场景一：首次装机——homeall.g里G28的正确打开方式（防撞床版）
新装Duet板，第一步不是G28，而是确保归位宏不会让打印头撞上热床。homeall.g必须包含安全抬升逻辑。
; homeall.g - 笛卡尔打印机安全归位宏 M140 S0 ; 关闭热床（防误触） M104 S0 ; 关闭喷嘴（防误触） G91 ; 切换到相对坐标 G1 Z5 F300 ; 先抬升Z轴5mm（避开热床） G90 ; 切回绝对坐标 G28 X Y ; 先归位X/Y轴（Z暂不归，防撞） G1 X100 Y100 F3000 ; 移动到床中心（安全位置） G28 Z ; 再归位Z轴（此时Z探针可安全探测） M140 S60 ; 开启热床预热逻辑说明：
G28 Z若在X/Y未归位时执行，打印头可能在床边缘，Z探针无法触发；先G28 X Y确保头在床面区域，再G1 X100 Y100移到中心，最后G28 Z。G91/G90切换是为安全抬升Z，避免绝对坐标下Z0导致撞床。
参数说明：
F3000：抬升速度，3000 mm/min足够快；G1 X100 Y100：假设床尺寸200x200mm，中心即(100,100)；- 验证：手动执行
homeall.g，观察Z轴是否在X/Y归位后才下降，且下降过程平稳触发探针。
4.2 场景二：双喷嘴Z校准——G30 S-2与G10 P1的精准配合
双喷嘴打印机必须保证两喷嘴Z高度一致，否则第二喷嘴会刮伤第一层。G30 S-2自动修正Z偏移，G10 P1保存结果。
; zprobe.g - 双喷嘴Z校准宏 T0 ; 切换到喷嘴0 G28 Z ; 归位Z（以喷嘴0为基准） G30 S-2 ; 探测当前点，将喷嘴0 Z设为0 T1 ; 切换到喷嘴1 G30 S-2 ; 探测同一点，自动修正喷嘴1 Z偏移 G10 P1 Z0 ; 将喷嘴1的Z偏移设为0（此时两喷嘴Z一致） M500 ; 保存到config.g逻辑说明：
G30 S-2的含义是“探测当前XY，将当前工具Z设为0”。第一次G30 S-2后，喷嘴0的Z=0；切换T1后，G30 S-2探测同一点，若喷嘴1比0高0.1mm，则固件自动将喷嘴1的Z偏移设为-0.1mm，使G10 P1 Z0生效后两喷嘴Z坐标相同。
参数说明：
G30 S-2必须在T0和T1后分别执行，且XY位置相同；G10 P1 Z0是冗余保险，确保偏移值为0；- 验证：执行后发
G10 P1无参数，RRF返回Tool 1 offsets: X0.00 Y0.00 Z0.00。
4.3 场景三：自动床平——G29与G32的抉择，何时用网格补偿、何时
本文还有配套的精品资源，点击获取
