KiCAD导出SMT坐标文件时单位错误怎么办？

Question

在使用KiCAD导出SMT贴片坐标文件（如用于钢网和贴片机的CSV或TXT文件）时，常遇到单位错误问题：导出的坐标单位显示为“inch”而非预期的“millimeter”，导致贴片厂误判位置。该问题通常源于PCB编辑器（Pcbnew）中未正确设置导出选项。尽管用户在界面中选择毫米单位，但若未在“文件 → 导出 → 装配文件”中明确勾选“使用毫米”或配置正确的格式模板，KiCAD可能默认输出为英寸。此单位混淆会直接引发贴片偏移甚至生产失败。如何确保KiCAD导出的SMT坐标文件单位统一为毫米并被贴片厂商正确识别？

Answer 1

确保KiCAD导出SMT坐标文件单位统一为毫米的完整指南

1. 问题背景与常见现象

KiCAD作为开源PCB设计工具，广泛应用于中小型企业及独立开发者中。在完成PCB布局后，导出SMT贴片坐标文件（通常为CSV或TXT格式）是交付给贴片厂的关键步骤之一。然而，许多用户反馈：尽管在KiCAD界面中已设置为毫米单位，但导出的装配文件中坐标单位仍显示为“inch”，导致贴片机误读位置，引发元件偏移甚至整板报废。

该问题的根本原因在于：KiCAD的Pcbnew模块在导出装配文件时，默认行为可能未继承主界面的单位设置，而是依据导出配置中的选项决定输出单位。

2. 技术原理分析：单位系统与导出机制

KiCAD内部采用双单位系统（毫米与英寸），用户可在界面右下角切换显示单位。但此切换仅影响视觉呈现，并不自动更改导出行为。真正决定导出单位的是“文件 → 导出 → 装配文件”对话框中的具体设置。

以下是导出流程中关键控制点：

• 导出路径选择：必须通过“文件 → 导出 → 装配文件”进入专用导出向导。
• 单位勾选项：“Use mm for coordinates”必须手动勾选，否则默认使用英寸。
• 格式模板：可自定义字段顺序和单位标识，避免厂商误解。
• 坐标原点设置：建议使用“Board Center”或“Absolute Board Position”以保证一致性。
• 层别区分：Top与Bottom层应分别导出或明确标注。
• 文件命名规范：推荐包含“mm”字样，如smt_coordinates_mm.csv。
• 注释行内容：前几行注释应清晰声明单位为毫米。
• 分隔符选择：CSV使用逗号，TXT可选制表符，需与贴片机兼容。
• 角度单位：旋转角度应为度（Degrees），非弧度。
• 零点补偿：若存在机械安装偏移，应在导出前在KiCAD中调整原点。

3. 解决方案步骤详解

1. 打开Pcbnew，加载已完成布线的PCB文件。
2. 确认当前视图单位为毫米（界面右下角显示“mm”）。
3. 点击菜单栏“文件” → “导出” → “装配文件…”。
4. 在弹出窗口中，勾选“Use mm for coordinates”选项。
5. 选择输出目录，并为顶层和底层分别设置输出文件名。
6. 在“Format”区域，确认字段顺序合理（如Reference, Value, Package, X, Y, Rotation, Layer）。
7. 点击“Generate”生成文件。
8. 用文本编辑器打开生成的CSV文件，检查前几行是否包含单位说明。
9. 验证至少三个元件的X、Y坐标是否符合预期位置（可通过测量工具比对）。
10. 将文件发送给贴片厂前，在邮件正文中明确注明：“所有坐标单位均为毫米（mm）”。

4. 验证与自动化建议

为防止人为疏忽，建议建立标准化输出流程。以下是一个典型的验证流程图：

        graph TD
            A[开始导出SMT坐标] --> B{是否通过'导出→装配文件'?}
            B -- 否 --> C[重新进入正确路径]
            B -- 是 --> D[勾选'Use mm for coordinates']
            D --> E[设置正确原点与层别]
            E --> F[生成CSV/TXT文件]
            F --> G[用文本编辑器查看单位标识]
            G --> H{第一行是否注明mm?}
            H -- 否 --> I[添加注释行: Units=mm]
            H -- 是 --> J[归档并发送给厂商]
            J --> K[记录本次导出配置用于复用]
    

5. 常见错误与规避策略

错误类型	表现形式	根本原因	解决方案
单位混淆	贴片机提示坐标超出范围	未勾选“Use mm”	严格遵循导出向导操作
原点偏移	所有元件整体偏移	原点设在图纸角落而非板边	使用“Absolute Board Position”
层别错乱	底面元件贴到正面	未区分Top/Bottom层	分层导出或加Layer列
旋转异常	IC方向反向90度	角度符号理解不一致	确认KiCAD角度为逆时针正向
字段缺失	贴片机无法识别元件值	模板未包含Value字段	自定义模板增加必要列
分隔符错误	数据列错位	使用空格而非逗号	选择标准CSV格式
文件编码问题	中文字符乱码	UTF-8 with BOM缺失	保存时指定UTF-8编码
重复导出覆盖	版本混乱	无版本号命名	加入版本与日期前缀
未验证输出	批量贴片失败	跳过人工检查	建立 checklist 核对机制
模板未保存	每次重新配置	未导出模板文件	导出 *.pos.cfg 模板复用