draw.io 桌面版完整教程:5 分钟装好,命令行批量导出 6 种格式
2026/9/15 17:44:21 网站建设 项目流程

draw.io 桌面版完整教程:5 分钟装好,命令行批量导出 6 种格式

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

每换一台电脑,之前画的架构图要么格式跑偏,要么得重新导一遍 PNG;同事要一份 PDF,你得手动导出一次。这篇文章带你把 draw.io 桌面版装起来、画出第一张图,再用命令行把整个目录的图表批量导成 PDF,从安装到上手大约 15 分钟。

📷 先认识一下这个应用

draw.io 桌面版是 draw.io 的官方 Electron 桌面客户端:Apache-2.0 开源、免费商用,图表数据只存在你自己电脑上,不上传。当前版本 31.4.2,基于 Electron 44,Windows、macOS、Linux 三平台同一份文件随便开。

🚀 快速上手:安装、画第一张图、导出

1. 安装:三平台各有一条路

系统拿到应用的两种方式适合谁
Windows官方安装版 / 免安装版办公机、无管理员权限
macOS.dmg 拖入"应用程序"Mac 日常画图
LinuxAppImage / deb / rpm / snap团队统一环境

图省事就装官方包,3 分钟搞定,官方包带签名,系统不会拦你。走源码路线要 4 步,注意第一个参数--recursive不能省——核心编辑器是 git 子模块,漏了它后面构建直接失败,细节见 doc/BUILDING_FOR_PERSONAL_USE.md:

git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install # 需要 Node.js 22.12+ npm start

2. 画第一张图

启动后界面分四块:左侧形状库、中间网格画布、右侧属性面板、底部页面标签。操作就三步:

  1. 左侧搜索框输入 "rectangle",把形状拖进画布——按名字搜比翻分类快
  2. 双击形状输入文字,右侧面板改填充色和描边
  3. 选中形状,从边缘虚点拖出连线到另一个形状

全程不碰任何菜单,10 分钟能出一张带文字和连线的流程说明图。

3. 保存和导出

  • 存成.drawio文件——它本质是 XML 结构,纯文本,可以进版本库,换任何一台电脑打开都不会变样
  • 要贴进文档就导出 PNG;要打印就导出 PDF
  • 想一次处理几十个文件?往下看

⚡ 进阶能力:命令行批量导出、Mermaid 与 Visio 迁移

1. 命令行批量导出——问题:几十张图逐张手动导出是苦力活。解法:给启动参数加-x,整个目录递归处理:

drawio -x -r -f pdf diagrams/ drawio -x -f png -s 2 flow.drawio

格式支持 pdf、png、svg、jpeg、xml、html 六种;不加-f默认就是 pdf。完整参数(边距-b、缩放-s、指定页码-p等)直接读 src/main/args.js 的源码,比看文档全。

2. 导出前自动排版——问题:手拖的图歪歪扭扭,交付前没时间对齐。解法:--layout在导出前跑一次自动布局,内置 6 种算法:verticalFlow、horizontalFlow、verticalTree、horizontalTree、radialTree、organic,流程图一般选 verticalFlow。

3. 用文本画图(Mermaid 与 CSV)——问题:图散落在口述和会议里,没法进版本库。解法:Mermaid 语法的.mmd文件会被直接渲染成可编辑图表,CSV 数据也能导入生成图。图从此像代码一样提交、评审、复现,这是图形工具里少见的工程化玩法。

4. Visio 老文件迁移——问题:公司遗留 .vsdx 不想重画。解法:文件菜单导入.vsdx,形状和连线保留下来继续编辑,零重绘成本。

💰 迁移账:从商业绘图工具切过来花多少

假设你现在用按人按年收费的付费画图工具,切到 draw.io 桌面版只有四本账:

  • 许可费:归零。Apache-2.0 免费商用,团队 10 个人和 100 个人都是 0
  • 学习成本:新人半天独立出图,界面逻辑就是"拖形状 + 连线",没有隐藏菜单
  • 文件迁移:.drawio 是 XML 文本,可 diff 可合并;.vsdx、.mmd、.csv 直接导入,存量资料不用重画
  • 团队一致性:Windows 和 Mac 同事之间传 .drawio 就是传同一个文件,不用互相导出件再核对格式

🛠️ 避坑清单:4 个高频问题

现象原因解法
升级后启动,界面还是旧的同一用户只允许一个实例,新进程把文件甩给旧进程彻底退出旧 draw.io 再启动
导出来的是 PDF,我要 PNG命令行默认导出格式就是 PDF显式加-f png
自己构建的版本被系统拦个人构建无签名,官方包才有用官方包;坚持自建就手动放行
内网升级失败,一直停在旧版更新通道不可达--disable-update或设DRAWIO_DISABLE_UPDATE=true,断网运行

🎬 现在就动手

  1. 装好对应平台的版本(3 分钟),或源码路线跑npm start
  2. 从形状库拖 3 个形状进画布,加文字、连起来,存成 .drawio
  3. 终端里drawio -x -f png把它变成图片,发给同事

💸 免费开源:Apache-2.0 许可,团队用不花一分钱 🔒 数据本地:图表不离开你的电脑 🖥️ 三平台通用:Windows、macOS、Linux 同一份文件 ⌨️ 批量处理:一条命令导出一整个目录

今天装好,15 分钟后你的第一张流程图就能发出去。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询