G-code 刀路与3D打印预览器打不开或显示异常？排错指南
按文件签名、版本、单位、坐标和浏览器资源顺序排查G-code 刀路与3D打印预览器，并保留原始文件。
不要先改后缀或覆盖原文件
复制一个样本用于排错，保留原始交付文件、文件大小、生成软件版本和错误提示。打开一份 FDM G-code，先确认 G21 毫米和 G90 绝对坐标，再查看首层边界、喷嘴/热床温度与挤出轨迹。对 CNC 文件则重点搜索 G54、G43、M6 和主轴命令。
推荐排查顺序
- 用工具页面的示例或一份更小的同类文件确认浏览器功能正常。
- 检查文件签名与扩展名是否一致，确认文件没有被下载为 HTML 错误页。
- 对照工具支持格式、大小上限和下面的专业检查项。
- 关闭其他大型标签页，在最新版 Chrome 或 Edge 重试。
- 仍异常时回到创建该文件的软件重新导出，并在正式专业软件中复核。
针对这个格式的检查
- G20/G21 单位和 G90/G91 模式明确
- XYZ 包围盒没有超出设备行程或打印床
- 快速移动与挤出/切削移动可区分，没有异常跨越
- 归零、工作坐标、温度、主轴和换刀命令符合目标控制器
常见错误与解决方法
模型比例大了或小了 25.4 倍
通常是英寸和毫米解释错误，检查 G20/G21 以及 CAM/切片器导出单位。
预览正常但机器动作不同
固件宏、坐标偏置、刀补和厂商命令由真实控制器解释，网页预览不模拟这些状态。
哪些情况不能靠网页工具
- 宏变量、子程序、厂商扩展和五轴运动可能不支持
- 估算时间不含真实加速度、固件规划和换刀
- 预览不能证明机床、夹具和坐标系安全
网页“能显示”只证明当前解析器读到了部分结构，不证明工程、生产、科研、商务或临床结果合规。正式交付应保留源软件和接收方的验证记录。
隐私与安全
本工具在浏览器本地读取文件，不会为解析而上传到 FreeTool。排错截图、导出 CSV 和浏览器下载仍可能包含敏感信息；共享前请脱敏，并在共享设备上清理这些副本。