SketchUp STL 插件从零到一把模型变成3D打印文件的完整实操记录【免费下载链接】sketchup-stlA SketchUp Ruby Extension that adds STL (STereoLithography) file format import and export.项目地址: https://gitcode.com/gh_mirrors/sk/sketchup-stl凌晨两点老周盯着屏幕上的导出失败四个字快把鼠标捏碎了。他在 SketchUp 里花了一下午搭的机械臂模型卡在了最后一步——切片软件只认 STL 格式而 SketchUp 原生根本不支持 STL。网上的教程翻了个遍不是让你装付费插件就是让你用各种奇奇怪怪的转换网站把模型丢上去还得担心隐私问题。后来他找到了一款叫 sketchup-stl 的开源插件。这是一款由 SketchUp 官方团队维护的 Ruby 扩展专门为 SketchUp 补齐 STL 文件格式的导入和导出能力。装上之后从建模到导出3D打印文件全程没离开过 SketchUp 界面。如果你也在跟老周一样的问题较劲这篇文章就是为你写的——我会从安装讲起一直讲到踩过的每一个坑。30秒速览这东西到底是什么sketchup-stl 本质上是一个 Ruby 扩展当前版本 2.2.0安装后会给 SketchUp 增加两个入口文件 → 导入新增 STL 类型文件 → 导出 STL...菜单项。它免费、开源、MIT 许可代码就放在 src/sketchup-stl/ 目录下英语、德语、荷兰语界面它都支持。维度说明能解决什么SketchUp 原生不支持 STL 导入导出它是那座桥导出能力支持 ASCII / Binary 两种格式可选单位可只导出选中物体导入能力自动识别 ASCII / 二进制支持单位缩放、合并共面、自动修复适合谁用 SketchUp 做3D打印模型的个人和工作室以及想学 Ruby 扩展开发的人不适合谁想用 SketchUp 做复杂曲面逆向建模的用户STL 本质是三角网格上手成本装一个 RBZ 文件点两下菜单为什么值得单独说一句它底层处理 STL 的很多思路比如下面要讲的单位换算和格式识别本身就是很好的学习材料读一遍 src/sketchup-stl/ 里的代码比看十篇博客都管用。上手三步曲从下载到第一次导出第一步拿安装包。从 SketchUp 扩展商店下载最新的 RBZ 文件。注意别下成旧的 zip 包——RBZ 才是 SketchUp 认可的扩展打包格式。第二步装进 SketchUp。打开窗口 → 扩展管理器Mac 上是SketchUp → 偏好设置点安装扩展选中刚下载的 RBZ 文件搞定。装完重启一下 SketchUp看到文件菜单里多出导出 STL...就说明成功了。第三步导一次试试。随便画个立方体文件 → 导出 STL...在弹出的选项窗口里保持默认值选个位置保存。用记事本打开刚导出的文件——你会看到一大段以solid开头、endsolid结尾的文本那里面每一行facet normal和三个vertex就是一个三角面。踩坑提示导出对话框里默认格式是 ASCII文件会比较大。确认流程没问题之前别急着追求文件小ASCII 格式能用文本编辑器直接检查内容排查问题方便得多。我的实操全流程一个花盆模型的完整旅程我拿自己最近做的多肉花盆练了一遍手过程比想象中顺但也翻过两次车。准备阶段。花盆在 SketchUp 里是个内外两层面的实体底部留了三个排水孔。导出前我做了两件事一是把所有辅助线删干净二是检查每个图层——导出器会跳过隐藏图层和隐藏对象这个逻辑藏在 exporter.rb 的find_faces方法里画图时随手藏的参考线不会污染文件但也意味着你以为导出了的东西可能根本没进去。第一次导出尺寸吓我一跳。我选了毫米单位导出然后在切片软件里打开花盆居然只有指甲盖大小。查了源码才明白原因SketchUp 内部所有长度都以英寸存储导出时按单位乘一个换算系数——毫米乘 25.4厘米乘 2.54英尺乘 0.0833。问题出在模型本身我在 SketchUp 里建的10 单位花盆其实是 10 英寸而不是 10 毫米。这不是插件的锅是建模时单位习惯的锅。把模型重建成毫米语义下的正确尺寸重新导出一切正常。第二次翻车是二进制格式。为了传文件方便我试了 Binary 格式。导出的文件确实小——二进制每条三角面固定占 50 字节80 字节文件头加 4 字节三角形数量后面就是密密麻麻的浮点数完全不可读。导入切片软件没问题但我想拿文本编辑器核对数据就做不到了。所以我的建议是给切片软件用二进制给排查问题用 ASCII。导入验证环节。我把导出的文件用文件 → 导入又拉回 SketchUp检验数据没丢。导入选项里有四个勾选项值得分别说清楚合并共面面把相邻且在同一平面上的三角面合并减少碎面对后续编辑友好单位缩放导入时按你选的单位重新缩放配合导出时的单位设置使用保留绘图原点勾选后几何保持原坐标不勾选会自动把模型移到原点附近修复几何这个后面单独讲是隐藏大招。整个流程走下来从 SketchUp 建模到切片软件就绪没碰任何第三方转换工具。进阶工具箱三个很少人知道的隐藏能力这招很少人知道——自动修复几何。STL 文件里模型不一定是水密的有破洞、有开放边界直接切片大概率打印失败。导入选项里的修复几何就是干这个的。它的实现很有意思往模型里塞一批零长度边再触发 SketchUp 内部的几何修复机制把顶点焊起来。源码在 src/sketchup-stl/ 的 utils.rb 里方法名叫heal_geometry。如果你的模型是网上下的、来源不明的 STL导入时千万别把这项关掉。这招也很少人知道——二进制文件的照妖镜识别。STL 分 ASCII 和二进制两种理论上 ASCII 文件以solid开头但有些二进制文件不守规矩头部也写solid光看开头根本分不清。sketchup-stl 的做法很聪明它跳过 80 字节头读出第 81 到 84 字节的三角形数量然后按80 4 50 × 三角形数算一遍文件大小跟实际文件大小一比对严丝合缝就是二进制否则就是 ASCII。这是我在 importer.rb 里读到的最漂亮的 trick 之一。最后一招——隐藏图层自动跳过导出。想导出模型的一部分又不想删掉另一半不用新建组件再单独选择把不想导出的内容放进隐藏图层就行。导出器遍历时遇到hidden?或者不可见图层里的对象直接跳过。配合仅导出当前选择没选中任何东西时会弹窗问你要不要导整个模型你能很灵活地控制导出范围。如果你对源码本身感兴趣可以用git clone https://gitcode.com/gh_mirrors/sk/sketchup-stl拉一份到本地慢慢看整个项目结构很干净exporter.rb、importer.rb、utils.rb三个文件基本就是全部核心逻辑。问答与收尾关于 SketchUp STL 导入导出的最后一轮答疑问导出的模型在切片软件里显示法线反了、破面怎么办先看是不是有翻转的组件或面。STL 格式要求顶点按右手定则排列而 SketchUp 里翻转的组件会破坏这个规则。sketchup-stl 在导出时会用叉积重新计算法线方向自动纠正顶点顺序源码在get_vertex_order方法里所以绝大多数情况下它会自己处理。真遇到问题用修复几何再导入一次试试。问导入的 STL 文件进来后模型巨大/巨小是插件坏了吗大概率是单位设置问题。STL 文件本身不带单位信息全靠导入时的单位缩放选项猜。源头文件如果是毫米导出的导入时就把单位选成毫米一般能对得上。问二进制和 ASCII 到底选哪个二进制文件体积小、解析快适合最终交付给切片软件ASCII 可读性好适合调试和二次处理。日常导给切片软件选二进制自己排查问题选 ASCII。插件会记住你上次的选择不用每次重设。问这个插件值得拿来学 Ruby 扩展开发吗值得。它结构清晰、注释友好、还自带一套完整的 UI 组件库SKUI从菜单注册、对话框到本地化字符串处理全都有。能完整跑通一个 SketchUp 扩展该有的所有环节是很典型的学习样板。写到最后我想起老周后来跟我说的话早知道有这东西我那两个小时的教程视频都白看了。 工具往往就是一层窗户纸sketchup-stl 把 SketchUp 和 3D 打印之间那层窗户纸捅破了。你的下一步很简单装上它画一个封闭的实体导出切片打印。从第一个成功的 3D 打印文件开始剩下的事情都会顺理成章。【免费下载链接】sketchup-stlA SketchUp Ruby Extension that adds STL (STereoLithography) file format import and export.项目地址: https://gitcode.com/gh_mirrors/sk/sketchup-stl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考