draw.io 桌面版完整实战指南装好就能画命令行批量导出图片数据留在本机【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktopdrawio-desktop 是 draw.io 编辑器的官方桌面构建用 Electron 壳把网页版编辑器装进本地应用免账号、可离线画流程图、UML、架构图图表文件不离开你的电脑。这篇按「装好 → 画出第一张图 → 用命令行批量出图 → 管好数据」的路子带你走完一遍。这东西到底是什么一句话draw.io 编辑器的官方外壳。真正的绘图引擎放在drawio/这个 git 子模块里本仓库负责桌面侧的一切——窗口、菜单、文件关联、自动更新以及命令行导出。参数解析逻辑写在 src/main/args.js 里想搞清楚某个开关的行为翻它最准。两个属性先记住采用 Apache 2.0 许可不改动代码就可以免费用于任何场景包括商用项目对外关闭代码贡献bug 和诉求照提但不接 PR。想改fork 一份自己构建是许可允许的。当前版本号 31.4.2写在 package.json正式构建时由 sync 脚本从drawio/VERSION盖章。自行构建需要 Node.js 22.12 以上。 挑安装包三个问题定下来别看文件名先回答三个问题。有管理员权限吗Windows 上 NSIS 安装包draw.io-version-windows-installer.exe装到 Program Files是整机安装需要管理员MSI 包draw.io-version.msi只装进当前用户目录不需要提权公司电脑上没权限就选它。微软商店版同样是按用户安装、不碰管理员权限。三种装完都会注册.drawio、.vsdx、.mmd的文件关联双击就能打开。不想装Windows 有便携版no-installer解压直接运行。代价是它不注册任何文件关联——双击.drawio打不开属于正常现象。什么系统macOS 提供 x64、arm64 和 universal 三种 dmgIntel 和 Apple Silicon 都能覆盖另有 zip 包可选。Linux 有 AppImage、deb、rpmx64 和 arm64 都有。ARM 版 Windows 则单独出 arm64 安装器和便携版。一个 2026 年的变化要留意底层 Electron 44 不再携带 32 位二进制官方包已取消 32 位 Windows 构建macOS 也要求 13 及以上。老机器就别硬凑了。️ 第一张图三步出图首次启动就是一块空白画布不用任何配置。在左侧面板搜索形状比如「rounded」拖一个圆角矩形到画布上鼠标停在图形边缘出现连接锚点后拖向另一个图形连线完成双击图形直接输入文字。菜单「文件 → 保存」命名后落盘为.drawio。图多了就在底部页面标签加页分开画。macOS 上还有个隐藏技能在 Finder 里选中.drawio文件按空格Quick Look 预览扩展会直接把渲染结果弹出来不用打开整个应用。 真正出活的地方命令行批量导出桌面版披着 GUI但本身也是个命令行工具用法是drawio [options] [输入文件或目录]...。-x表示导出-f指定格式把架构图出成 PDF 就这样一条drawio -x -f pdf 架构图.drawio格式支持 pdf、png、jpg、svg、xml、html不写-f默认 pdf。几个高频用法文档配图整目录批量出图drawio -x -f png -r diagrams/-r递归子目录-o指定输出文件或目录。输出了指定扩展名的文件名时以扩展名为准。PPT 透明底--transparent给 PNG/SVG 去底-b控制四周留白。挑页面图片格式默认只出第一页-p按页码选从 1 数起--all-pages把全部页面打进一份 PDF。自动排版--layout verticalFlow在导出前跑一次布局verticalFlow、horizontalTree、radialTree、organic 等六种预设可选。不止 .drawio.vsdx、.csv、.mmd/.mermaid都能当输入客户丢来的 Visio 文件可以直接打开Mermaid 文本能批量变成可编辑图。还有个实用开关-e会把图的数据副本嵌进导出的 PNG/SVG/PDF 里之后在 draw.io 里打开这张图还能回到可编辑状态适合「图在文档里流转」的团队。 数据存哪怎么断网本地状态含 electron-store 的设置放在WindowsC:\Users\用户名\AppData\Roaming\draw.io\macOS~/Library/Application Support/draw.io备份就是把这整个目录拷走。应用默认唯一的网络行为是启动时的版本检查——查一下有没有新版本仅此而已。不发送任何使用统计图表内容不外传内容安全策略直接禁止运行远程加载的 JavaScript。唯一要留神的例外图表自身引用了外部资源URL 加载的背景、图片、字体时打开文件就会去请求那些地址。图表内容不会因此泄露但请求本身可能把你的 IP 暴露给对方服务器。来历不明的.drawio文件打开前多想一秒。彻底断网内网机器常用drawio --disable-update或者设环境变量DRAWIO_DISABLE_UPDATEtrue。Flatpak 渠道会自动禁用更新做开发的话还有--no-silent-update把静默更新改成下载前先询问。️ 自己构建三条命令出本地二进制不信预编译包、或想改壳官方路子是git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm run sync npm run release-linux--recursive不能省drawio 核心编辑器是子模块少了它构建直接失败忘了加就补git submodule update --initnpm run sync把drawio/VERSION的版本号写进 package.json 并生成src/main/disableUpdate.js构建前必须跑产物落在dist/Linux 是 AppImage/deb/rpm。Windows 用release-winx64或release-win-arm64商店版release-appx、Snap 版release-snap每个命令对应一份 electron-builder 配置文件。fork 改完想出自己的个人版设DRAWIO_UNSIGNEDtrue跳过签名和公证系统会弹安全警告自建产物自负。完整步骤、各平台的坑都写在 doc/BUILDING_FOR_PERSONAL_USE.md。调试阶段npm start可直接从源码跑起来注意 draw.io 同用户只允许单实例——官方版本正在运行时你的新窗口会被塞进官方实例里改动看着没生效。❓ 常见问题双击 .drawio 没反应多半在用便携版它不注册文件关联。换 NSIS/MSI 安装或手动把该扩展名的默认打开程序指到桌面版。内网机器首次启动卡住或超时九成是版本检查连不出去。加--disable-update或设环境变量问题解决。自建包安装时系统报警告正常吗正常。自建包不签名SmartScreen、Gatekeeper 的提示都是预期行为。macOS 上从别的机器拷来的自建应用若报「已损坏」拷到 /Applications 后执行一次xattr -cr /Applications/draw.io.app清掉隔离标记。能向社区提交代码吗不能项目长期关闭贡献。但 Apache 2.0 允许 fork 后自行构建自用只是别把自改版当官方版本发出去。怎么看版本和完整参数drawio -V出版本号drawio -h打印完整参数表比翻文档快。✅ 收尾行动清单按权限情况挑安装包装上确认.drawio、.vsdx双击可开画一张流程图保存成.drawio走一遍「画 → 存 → 重开」命令行跑一次drawio -x -f png拿到第一张导出的 PNG把数据目录Windows 的 Roaming、macOS 的 Application Support整目录备份一份内网环境给启动快捷方式加上--disable-update。装好到出第一张图几分钟的事剩下的是把导出参数和备份习惯用熟。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考