draw.io 桌面版：6 种格式一条命令批量导出，三平台免费的画图指南-平芜编程栈

draw.io 桌面版：6 种格式一条命令批量导出，三平台免费的画图指南

【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop

draw.io 桌面版（drawio-desktop）是 draw.io 绘图工具的官方 Electron 打包，Windows、macOS、Linux 全平台免费，采用 Apache-2.0 开源许可。说白了，它把浏览器里那套画图能力装进了本地：流程图、UML、网络拓扑随画随存，文件躺在你自己硬盘上；真正值钱的是命令行——一条命令就能把整个目录的图批量导出成 PDF、PNG 等 6 种格式。全文 3 分钟扫完，读完你能装好它、画出第一张图、跑通一次整目录批量导出。

装之前先看三件事：版本、许可、它碰不碰网络

项目	说明
当前版本	31.4.2，见 package.json
许可证	Apache-2.0，个人和公司都能免费用、可改源码、可再分发
技术栈	Electron 44，源码全部开放
源码构建要求	Node.js 22.12 及以上

它只在检查更新时联网，画图数据本身不出本机。要彻底断网，源码里只认两个开关：启动参数--disable-update，或环境变量DRAWIO_DISABLE_UPDATE=true，判断逻辑就在 src/main/electron.js 的disableUpdate常量里，可以自己核实。

合规内网机器直接用环境变量拉起就行，从此不碰网络。

三条安装路径对比：选最省事的那条

形态	动作	适合谁
Windows：.exe / 免安装版 / MSI	双击安装；免安装版解压即跑	办公机；没有管理员权限就选免安装版
macOS：.dmg	挂载后拖进"应用程序"	Mac 日常使用
Linux：AppImage / deb / rpm / snap	加执行权限直接跑，或包管理器一条命令	团队标准化环境

想跑最新代码或改点东西，源码路径最短就三步。第一条必须带--recursive——核心编辑器是个 git 子模块，漏了它构建直接失败：

git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop && npm install && npm start

已经忘了带参数克隆的，补一句git submodule update --init就能补救。签名说明、各平台打包命令这些细节，个人构建指南写得比这里全，照着做即可。

4 类高频场景：谁在什么时刻用它

梳理业务流程的人：SOP 十分钟一张图

给非技术同事讲系统、写 SOP 文档，从 General 分类拖形状、加箭头连线，十分钟出一张能直接贴进文档的流程图。画乱了不用手调，导出时加个--layout让它自动摆正。

接手 Visio 遗产的人：.vsdx 直接导入接着改

机房架构、老 Visio 文件，导入 .vsdx 后形状和连线都保留，不用照着原图重画。对还在用 Visio 的团队，这是迁移成本最低的一条路。

赶设计评审的工程师：UML 类图、时序图随缺随补

设计文档缺什么图补什么：类图、时序图、状态图都能在同一个 .drawio 文件里画。评审前导出 PNG 贴进文档，意见改完再导出一次，全程不切换工具。

把图当代码管理的人：Mermaid 和 CSV 也能变成图

写.mmd文件会被渲染成可编辑图表，CSV 数据直接导入生成图；.drawio 本质是 XML，能进版本库做 diff。工程师改图可以像改代码一样可复现，这是它和纯画图软件最大的区别。

命令行批量导出：整目录一次出 6 种格式

6 种格式速查：

格式	参数	最适合
PDF	`-f pdf`（默认）	打印、正式分发
PNG	`-f png`	贴网页、文档、PPT
SVG	`-f svg`	矢量放大不失真，字体默认内嵌
JPG	`-f jpeg`	通用图片，文件更小
XML	`-f xml`	结构化数据给程序处理
HTML	`-f html`	生成可交互查看的网页

最短的三条命令：

drawio -x -f png flow.drawio # 单文件导出 PNG drawio -x -r -f pdf diagrams/ # 递归整个目录导出 PDF drawio -x -f svg --layout organic flow.drawio # 导出前先自动布局

第一条里-x表示导出、-f png指定格式；第二条加-r递归子目录，一个图表文件夹一次出完；第三条的--layout支持 6 种内置算法：verticalFlow、horizontalFlow、verticalTree、horizontalTree、radialTree、organic。页边距-b、缩放-s、页码-p这些细项不想背，直接翻 src/main/args.js，每个参数都有注释。

踩坑速查：4 个高频问题的现象与解法

现象	原因	正确做法
换了构建版本，界面还是旧的	同一用户只允许一个运行实例，新进程会在旧进程里开完窗口后自己退出	先彻底退出所有 draw.io 进程再启动
导出拿到的却是 PDF	命令行的默认导出格式就是 pdf	显式加`-f png`、`-f svg`等
个人构建被系统安全软件拦截	官方安装包有签名公证，个人构建默认无签名	用官方安装包；坚持自建就在打包时设`DRAWIO_UNSIGNED=true`并手动放行
点更新后一直停在旧版本	更新通道当前不可达	按应用内提示去官网手动下载最新版覆盖安装