draw.io 桌面版：离线画流程图，10 分钟批量导出整个目录的图表-平芜编程栈

draw.io 桌面版：离线画流程图，10 分钟批量导出整个目录的图表

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

draw.io 桌面版是一款免费（Apache 2.0 许可）、完全离线的流程图工具，基于 Electron（开源桌面应用框架），用来画流程图、UML、网络拓扑图，也能用命令行把一个目录的图表批量转成 PNG/SVG/PDF。全部脚本内置在应用包里，断网也能完整工作。照本文操作，10 分钟画出并导出第一张图，批量转换一条命令搞定。

快速上手：10 分钟画出并导出第一张图

从官方 Releases 页面下载安装包，装好之后 10 分钟就能拿到第一张导出的图。

按权限选安装包：Windows 上有 3 种——installer.exe（整机安装，需管理员）、.msi（只装当前用户，免管理员）、no-installer.exe绿色版（免安装免权限）。先说结论：没有管理员权限就选后两种。
安装后打开（绿色版直接双击运行），界面是三块：左侧形状库、中间画布、右侧属性面板。
从左侧库把矩形、菱形拖进画布，用箭头连起来，就是一张流程图。
文件菜单 → Export As → 选 PNG → 保存，第一张图完成。

离线批量转换：一条命令把整个目录的 .drawio 转成 PNG

装好的 draw.io 本身就是命令行工具，批量转换一个目录只需要一行命令。

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

-x启动导出，-r递归子目录，--transparent透明背景（仅对 PNG/SVG 生效）。其他高频选项：-a导出全部页面（PDF/HTML），-b 10四周加 10 像素留白，-s 2输出两倍尺寸，--theme dark深色背景。

输入不局限于 .drawio：Visio 的 .vsdx、.csv、Mermaid 的 .mmd 都能直接转换。全部参数定义见 src/main/args.js，运行drawio -h可看完整帮助。

导出单张图：PNG、SVG、PDF 等 6 种格式

单张图走界面比命令行更快。

文件菜单 → Export As，选 PNG、SVG、PDF、JPEG、XML、HTML 六种格式之一，对话框里可设边距、缩放、是否透明背景，日常够用。

图片格式默认只导第一页：想换页用-p指定页码，要整份多页就导 PDF 并加-a。

完全离线运行：图表数据不外传

默认情况下，应用不会把图表内容和任何使用统计发到网络上。

所有 JavaScript 都内置在应用包里，内容安全策略（CSP，浏览器里阻止加载外部资源的规则）明确禁止执行远程加载的脚本。唯一的网络请求是启动时的版本检查，可随时关闭（见下节进阶）。

有一个例外：如果 .drawio 文件里用 URL 嵌入了外部图片、背景或字体，打开文件时应用会请求这些地址以保证渲染正确。所以打开来源不明的图表文件，相当于把 IP 暴露给那个 URL——图表内容本身不会外传。

进阶：自构建、关闭更新检查、本地数据在哪

想关更新、改应用或清理数据，看下面三处即可。

关更新检查：设环境变量DRAWIO_DISABLE_UPDATE=true，或启动时追加--disable-update，集中部署的场景常用。

本地数据：macOS 在~/Library/Application Support/draw.io，Windows 在C:\Users\<用户名>\AppData\Roaming\draw.io\；偏好设置通过 electron-store（内置的配置持久化库）存在同一目录，迁移或清理数据认准这里。

自构建需要 Node.js 22.12 以上。编辑器本体是 git 子模块（git 的子仓库机制，位于drawio/目录），clone 必须带--recursive：

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

然后npm install、npm start即可启动，设DRAWIO_ENV=dev会顺带打开 DevTools 方便调试。自构建是未签名的：设DRAWIO_UNSIGNED=true跳过签名和公证。官方仓库不接受外部 PR，自改版本仅供个人使用，详见 doc/BUILDING_FOR_PERSONAL_USE.md。

避坑清单：6 个容易踩的坑

下面每个坑原因固定，一句话就能解决。

启动自构建版本改动不生效 → draw.io 每个用户只允许单实例运行，第二个进程只会把窗口开进第一个进程 → 先关掉官方应用再启动自构建版。
导出的图只有第一页 → 图片格式默认只导出第一页 → 用-p指定页码，或导 PDF 加-a出全部页面。
透明背景没生效 →--transparent只对 PNG 和 SVG 有效，JPEG 没有透明通道 → 改导 PNG。
clone 了仓库但项目打不开 → clone 时漏了--recursive，drawio/ 目录下的编辑器子模块没拉下来 → 重新带--recursive克隆。
macOS 自构建版在 Finder 按空格没有预览 → 未签名的自构建通常加载不了 Quick Look 预览扩展 → 自构建版直接视为没有预览功能。
打开图表文件时发起了外部请求 → 图表里嵌了 URL 引用的图片或字体，打开时会请求 → 隔离环境不要打开来源不明的图表文件。