先抛一个场景:客户发来一张 DWG,你不需要装任何 CAD,也不用上传到某个云服务,打开浏览器就能看、能缩放、能量距离;更进一步,你可以把这个图纸直接变成一个 .html 文件,发给对方,对方双击就能在浏览器里翻。
这不是设想,是 MLightCAD 已经在做的事。它的自我描述很直白:世界上第一个完全跑在浏览器里、不依赖任何后端服务的 DXF/DWG 查看与编辑器。

核心思路:解析和渲染全在浏览器
DWG/DXF 的解析、几何处理、渲染,全部在前端完成。没有服务器参与,意味着三件事:
- 文件不出本机。对图纸保密有要求的行业,这点比什么功能都重要。
- 不用搭后端。嵌入到自己网站里,只是一行 iframe 的事。
- 离线可用。断网也能打开,配合 PWA 或者离线 HTML 更彻底。
技术上它基于 Three.js / WebGL,但做了大量针对性优化:自定义着色器材质渲染复杂线型和填充,几何合批把同材质的点线面并成一次绘制,重复几何用实例化,材质缓存减少状态切换。所以大图纸也能保持 60+ FPS。
最有意思的功能:导出离线 HTML
大多数 CAD 查看器只让你在它自己的产品里看。MLightCAD 可以一键把当前图纸导出成一个自包含的 .html——里面嵌了图纸快照和一个轻量查看器运行时。
收件人拿到这个文件,在任何现代浏览器里双击打开,就能平移、缩放、开关图层、量距离,中英文界面都有。不需要装 CAD,不需要服务器,不需要 MLightCAD 实例。
适合的场景一抓一大把:发给客户的方案图、归档留存的竣工图、隔离网络里的内部传阅、放在静态文件服务器上给团队看。
还有个意外的好处是内存占用。官方拿同一张 canteen.dwg 做了对比:
| 查看方式 | 内存占用 |
|---|---|
| AutoCAD 2020 | 320 MB |
| 浩辰看图王 | 246 MB |
| 离线 HTML(测量模式) | 56 MB |
| 离线 HTML(查看模式) | 33 MB |
查看模式比 AutoCAD 省了约 83%,比浩辰省了约 77%,而且照样能平移缩放、开关图层、量距离。
一行 iframe 嵌到自己的网站
不想接 SDK、不想装包,直接用 iframe:
<iframe
src="https://mlightcad.com/embed.html?url=https://example.com/plans/floor.dwg&mode=review&toolbar=1"
style="width:100%;height:600px;border:0"
allowfullscreen>
</iframe>
文件从你自己的 URL 拉,在访问者的浏览器里解析,全程不经过任何第三方云。平移、缩放、测量、批注这些审图工具开箱即用。对内部系统、客户门户这类“图纸不能外传”的场景,这条路径很干净。

还有一种玩法:服务端预渲染
纯前端解析的代价是每次打开都要重新解析一遍。MLightCAD 也提供了服务端预渲染:服务器上解析一次,客户端只负责显示结果,不再重复解析和重建几何。
好处是客户端内存占用非常低,同一张图第二次及以后打开快得多——这个特别适合手机。官方有个 Next.js 示例 cad-viewer-nextjs-demo:分片断点续传上传、SQLite 存文件列表加缩略图,打开时可以在“浏览器实时解析”和“服务端预渲染”之间选。
功能到底做到哪一步
项目很坦诚地把路线图摊开,已完成和未完成都标着。已完成的部分已经不少:
- 文件:DXF/DWG 读取(R12 到最新版本)、大文件流式增量加载、导出离线 HTML
- 数据模型:统一实体模型、图层表、块/插入结构、XData、代理实体
- 渲染:图层组织场景、布局/图纸空间、视口实体、几何合批、空间索引
- 显示:图层开关/冻结/锁定、线宽、线型比例、背景主题
- 选择:单选、窗选、交叉选、按类型/图层过滤、选择循环
- 捕捉:端点、中点、圆心、交点、最近点
- 编辑:移动、复制粘贴、旋转、缩放、删除、撤销重做、夹点、偏移
- 绘制:直线、多段线、样条、圆、弧、椭圆、矩形/多边形、填充、单行/多行文字、标注、块创建与插入
- 测量:距离、弧长、面积、角度、坐标、实体统计
- 界面:属性面板、图层管理器、块管理器、命令行(带别名和 AutoCAD 风格提示)、状态栏
- 移动端:响应式布局 + 触摸手势(双指缩放、单指平移、点击选择)
还没做的也写得很清楚:拉伸、修剪、延伸、炸开、圆角倒角、LOD 渲染、多画布分块、命名视图、协作编辑等等。这种“把缺口亮出来”的路线图,对想参与的人其实更友好。
DWG 这块要留意许可
DXF 用的是自带的 MIT 解析器,没包袱。DWG 是可选项:@mlightcad/cad-simple-viewer 默认不依赖也不注册任何 DWG 转换器。想要开源 DWG 支持,得自己加 @mlightcad/libredwg-converter——那是 GPL-3.0。
LibreDWG 的现状作者写得很实在:实体覆盖有限、WASM 包大约 13 MB、启动慢、内存高、超大 DWG 可能 OOM,还会带来 GPL 传染问题。
如果你要更好的兼容性、更小的包体、更大的文件支持,或者闭环商业授权,他们提供专有 DWG 解析器:包体约 437 KB、启动快得多、覆盖更广、没有 GPL 传播风险。商业项目要闭源分发的话,这条是必选项。
自己跑起来
git clone https://github.com/mlightcad/cad-viewer.git
cd cad-viewer
pnpm install
pnpm dev # 完整版查看器
pnpm dev:simple # 简化版
pnpm build # 构建
pnpm preview # 预览构建产物
需要 Node.js 24+ 和 pnpm 10+。npm 上的包分几个层次:@mlightcad/cad-simple-viewer(最轻,适合嵌进自己的应用)、@mlightcad/cad-viewer(完整 Vue 界面)、@mlightcad/cad-editor(带菜单、功能区、命令行、状态栏)。
已经有不少产品建在它上面:Thingraph 做了 DWG Viewer 的网页版、Google Drive 插件、VS Code 扩展、Cursor 扩展、Confluence 插件、Windows 资源管理器缩略图;社区还有 Nextcloud 应用,以及 Arch Linux 的 AUR 包。
适合谁
- 要在自己网站/内部系统里嵌 DWG 预览的开发者(一行 iframe 或几个 npm 包)
- 需要把图纸离线归档、发给客户、放进隔离网的团队
- 对图纸保密敏感、不接受上传到第三方的行业
- 想在移动端看图纸,又不想装 App 的人
核心是 MIT,可以商用;但如果要用它处理 DWG 并闭源分发,记得先想清楚 GPL 那条路还是买专有解析器。
最后
“浏览器里看 DWG”这件事本身不稀奇,稀奇的是全程不碰后端,以及把图纸变成可以邮件发送的单个 HTML 文件。前者解决保密和部署,后者解决分发和归档,两个都是长期被忽略但实际天天遇到的痛点。
它的目标是做成浏览器里的完整 2D AutoCAD——查看器加编辑器。路线图还长,但底子已经打得挺扎实了。
- 仓库:https://github.com/mlightcad/cad-viewer
- 官网:https://mlightcad.com/
- 在线演示:https://mlightcad.netlify.app/
- 文档:https://cad-viewer.readthedocs.io/









