CAD‑Viewer 的离线kan图功Neng，听起来像是高大上技术，实际上你只需要一张普通的 HTML 页就Neng搞定。 哈哈，别以为这就是炫技，它geng像是给老朋友送的便携式笔记本，随时随地打开就Nengkan到图纸。 说实话，谁没想过把那些厚重的 DWG 文件压缩成一个小文件，然后发给客户或同事？

想象一下你双击一张 .html 文件，浏览器立刻渲染出三维视图；你Ke以旋转、缩放，还Neng测量距离。 那一切dou在浏览器里完成，没有 AutoCAD，也没有网络连接。 正因为它是单文件，所以分享也超方便——直接拖到邮箱附件，或者存到云盘，让人立刻打开就Nengkan。

步骤其实hen简单：先把 DWG 或 DXF 转成快照，再把快照打包进一个完整的 HTML。 那个快照里保存了所有几何信息和层级结构，只要有它，你就Neng复现原图的大部分交互体验。

下面给你展示一个典型的命令行流程： pnpm export:html # 在浏览器里打开 tmp/minimal-line.html，跟同事吹 “kan，一条线也Neng离线” Ru果你想批量导出，只需改文件名即可： pnpm export:html -- input.dwg -o out.html 命令会自动下载运行时脚本并内联到页面里无需额外文件。

整个过程分为两班车：A 车负责导出 B 车负责查kan。 A 车拿 DWG -> 场景 -> 快照 -> HTML；B 车拿同样的 HTML -> Runtime -> WebGL 渲染。 这里用到了 Three.js Zuo三维渲染，还有专门打包快照的工具 AcExSnapshotV1。 这一步骤完全在浏览器内完成，没有后端服务器参与。

flowchart LR
    subgraph 导出
        DWG
        Scene
        Snap
        HTML
        DWG --> Scene --> Snap --> HTML
    end
    subgraph 查kan
        HTML2
        RT
        GL
        HTML2 --> RT --> GL
    end
    HTML -.->|同一个文件| HTML2

一句话：把 CAD 图纸变成单文件离线可视化，就是把所有资源一次性打包进一个页面里然后让浏览器负责渲染和交互。 这种方式兼顾了安全性和易用性——对方既不用安装任何软件，也不会无意中泄露原始数据。

你可Neng会想：“我写了这么多精彩内容，怎么没被百度抓到？” 那么问题往往不是内容质量，而是索引策略与技术细节。 Ru果你的页面用了 robots.txt 阻止搜索引擎访问或者加了 meta 标签 ``，那自然不会被收录。当然这些dou只是例子，并非绝对规则；但多数企业为了保密或防止爬虫带来流量，会默认开启这些限制。 即使没有显式禁止，Ru果页面缺乏足够的关键词密度或结构化数据，对搜索引擎来说也难以判断其价值，从而降低抓取优先级。所以在写文章时要适当加点关键词，但别过度堆砌，否则反而会被误判为垃圾内容。 Zui后百度对技术类文章geng偏好具有行业权威性的站点。Ru果你的域名或作者账号没有一定影响力，即使内容优秀，也可Neng排在搜索结果末尾。所以从长远来kan，需要持续geng新并提升站点信誉才Neng真正登顶搜索结果页。这就是为什么有时候即便写得再好，也会发现自己在百度搜索中像个“隐形人”。

先确保你的服务器允许爬虫抓取；去掉 robots.txt 中的不必要限制；然后提交站点地图，让爬虫知道哪里值得抓取。另外把文章拆成几块小教程，每块dou配上图片和代码示例，Ke以提高读者停留时间，从而得到geng好的排名指标。但Zui重要的是保持geng新——每周发布一篇相关新技巧，让算法kan到活跃度。

我以前也遇到过类似需求：项目里有人说“我们必须给客户kan设计稿，但又不Neng让他们直接拿走”，于是我就尝试了这套离线单文件方案。一开始手动打包感觉麻烦，但后来我找到了 CLI 工具，只需一次命令即可完成全部流程。不仅省去了安装 AutoCAD 的繁琐，还大幅缩短了交付周期。

有个小技巧：Ru果你担心测量单位显示不准，Ke以在导出前先确认原始图纸单位是否正确。有时候单位差异导致Zui终显示的小数点位数跟预期不一致，只要回去检查一下源文件就行，不必怪代码。

坑1：忘记安装 Chromium —— CLI 内部用 Playwright 打开 Chromium 导出快照，Ru果没有 Chromium 就报错。不过一次跑完后它会自动下载对应版本。

坑2：输出路径写错 —— Ru果没有指定 -o 参数，它默认把 .dwg 同名改成 .html 放在当前目录。但Ru果你想输出到其他目录，请务必加上完整路径。

坑3：中文标题乱码 —— 在生成命令里加 `--locale zh --title "我的图纸"` Ke以保证页面标题正确显示。

# 正确写法
pnpm export:html -- input.dxf -o out.html
# 错误写法
pnpm export:html input.dxf -o out.html
# 对不起，我之前说错了现在Yi经改正。

其实这个工具还Neng支持多语言界面只要在导出命令里加 `--locale en` 或 `--locale zh` 就行。不管你是在国内还是海外douNeng轻松切换语言界面让用户体验geng加友好。当然Ru果你想geng进一步自定义 UI 样式，Ke以修改模板中的 CSS 或直接覆写 JS 函数。但大多数情况下默认风格Yi经足够专业。

只需一张精心打包的 .html，就Neng让任何人随时在线下查kan CAD 图纸，而无需担心安全泄露或安装软件的问题。这种“单文件离线可视化”方案，是技术团队解决跨平台共享的一大利器，也是未来趋势之一。 # 用好它，让设计分享变得轻松愉快吧！ # "咱就是说Ru果还有什么疑问，就直接发消息，我随时帮忙！"