draw.io 桌面版完整指南：离线画流程图，命令行 10 分钟完成批量导出

draw.io 桌面版完整指南：离线画流程图，命令行 10 分钟完成批量导出

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

draw.io 桌面版是 draw.io 编辑器的官方 Electron 打包，Apache 2.0 许可、免费商用。它把全部脚本内置在应用里，不联网也能完整画图，并支持 PNG、SVG、PDF、JPEG、XML、HTML 六种导出格式。对需要批量转换图表的团队，它本身还是一个命令行工具：装完应用，一条命令就能把一个目录的图表递归转成图片。普通用户约 10 分钟可以从安装走到导出第一张图。

它解决什么问题：图表不出网，内网也能用

先说结论：适合两类人——内网/离线环境里画流程图的工程师，和需要脚本化批量转换图表的 CI 流程。

• 数据不上传：官方安全设计目标是与应用完全隔离，界面层的内容安全策略（CSP）禁止执行远程加载的 JavaScript，图表内容从不外发，也不收集使用统计。
• 唯一联网动作是启动时的版本更新检查，可随时关闭（见后文）。
• 一个例外要知道：如果.drawio文件里用 URL 嵌了外部图片、背景或字体，打开文件时应用会请求这些地址来保证渲染。打开来源不明的图表，等于把你的 IP 暴露给那个 URL——图表内容本身不会外传。

免管理员安装与首次运行：MSI 还是绿色版？

Windows 提供三种安装包，没有管理员权限就选.msi或绿色版：

• installer.exe（NSIS）：装到Program Files、整机生效、需要管理员；
• .msi：装到当前用户目录、免管理员，日常首选；
• no-installer.exe：解压即用，但不注册文件类型关联，.drawio文件双击不会默认用它的打开。

Microsoft Store 的 APPX 版同样按用户安装、免管理员。装好打开后界面分三块：左侧形状库（搜索框 + 分类）、中央可无限缩放的画布（底部页签支持单文件多页）、右侧属性面板（字体、纸张、连接点）。新建文件可直接套用流程图、UML 等内置模板。

想要开发版或自改版本：需要 Node.js 22.12 以上，编辑器本体是 git 子模块（drawio/目录），克隆必须带--recursive，否则项目打不开：

git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop

接着npm install、npm start即可运行；设DRAWIO_ENV=dev会顺带打开 DevTools 方便调试。

批量导出图的命令行参数：一条命令递归转换整个目录 ⚡

单张图走界面：菜单 Export As 里选格式、设边距和缩放。批量则直接用安装好的应用当 CLI，把整个目录递归转成透明底 PNG：

drawio -x -r --format png --transparent ./diagrams

高频参数速查（完整定义见 src/main/args.js，drawio -h可看全部帮助）：

参数	作用	注意
-x	开启导出模式	输入不限于.drawio，.vsdx、.csv、.mmd/.mermaid也能直接转
-r	递归处理子目录	配合目录输入使用
--format	输出格式 pdf/svg/png/jpeg/xml/html	默认pdf；若输出名带了扩展名，此项被忽略
-a	导出全部页	只对 PDF 和 HTML 生效
--size page	导出整页而非按图元裁剪	适用于 png/jpg/svg，默认diagram会裁剪内容
-b 10/-s 2	四周留白 10px / 放大 2 倍	出高清图常用
--theme dark	深色背景导出	适用于 svg/png/jpeg/pdf
-k	不覆盖已存在的输出文件	重复跑脚本时防误覆盖

容易踩的坑：单实例、格式限制与权限

• 同用户只能跑一个实例：应用通过app.requestSingleInstanceLock()强制单实例，第二次启动只会往第一个进程里开新窗口——自改版本的改动不会生效。先关掉官方应用再启动自构建版。
• 图片格式默认只导第一页：多页想完整出来用-a（限 PDF/HTML），或指定页码-p <n>。
• --transparent只对 PNG 和 SVG 生效：JPEG 没有透明通道，要透明底请改导 PNG。
• 自构建版本是未签名的：设DRAWIO_UNSIGNED=true跳过签名和公证（完整步骤见 doc/BUILDING_FOR_PERSONAL_USE.md），系统会弹安全警告；macOS 官方版带的 Quick Look 文件预览扩展在自构建版上大概率加载不了。
• 官方仓库不接收外部 PR：自改版仅供个人使用，升级方式变成"拉取—重新构建—重装"。
• 关更新检查：设环境变量DRAWIO_DISABLE_UPDATE=true，或启动时加--disable-update；Flatpak 沙箱会自动关闭。集中部署常用。

常见问题 ❓

本地数据在哪，能迁移吗？能。macOS 在~/Library/Application Support/draw.io，Windows 在C:\Users\<用户名>\AppData\Roaming\draw.io\，应用偏好设置（electron-store 持久化）也在同一目录，搬家时整个目录拷走即可。

能只导出 PDF 里的某几页吗？能。-g 2..5指定页范围（仅 PDF 格式），-p 3选单页；配合--crop还能把 PDF 裁剪到图元大小。

绿色版为什么双击 .drawio 没反应？绿色版不注册文件类型关联，这是设计如此。需要右键"打开方式"手动选应用，或改用 MSI/NSIS 安装获得系统级关联。

Mermaid 文件怎么参与批量转换？.mmd/.mermaid是受支持的直接输入，drawio -x -f png diagram.mmd即可；若只想当静态图导入而不是可编辑图表，加--mermaid-image。

自改版和官方版能同时打开两个窗口吗？不能"双实例"。第二个进程会把窗口开进第一个进程里，你的自改版改动因此看不到任何效果。

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