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 日常画图 |
| Linux | AppImage / 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 start2. 画第一张图
启动后界面分四块:左侧形状库、中间网格画布、右侧属性面板、底部页面标签。操作就三步:
- 左侧搜索框输入 "rectangle",把形状拖进画布——按名字搜比翻分类快
- 双击形状输入文字,右侧面板改填充色和描边
- 选中形状,从边缘虚点拖出连线到另一个形状
全程不碰任何菜单,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,断网运行 |
🎬 现在就动手
- 装好对应平台的版本(3 分钟),或源码路线跑
npm start - 从形状库拖 3 个形状进画布,加文字、连起来,存成 .drawio
- 终端里
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),仅供参考