draw.io 桌面版上手路线:离线画图 + 1 条命令批量导出
2026/9/9 12:34:00 网站建设 项目流程

draw.io 桌面版上手路线:离线画图 + 1 条命令批量导出

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

draw.io 桌面版是一款免费的离线绘图工具,画流程图、UML、网络拓扑,导出 PNG、SVG、PDF 等 6 种格式。它适合内网机器和要批量出图的工程团队:图不经过外网,几十个图表文件一次转完。

从零到第一张图:免管理员安装方法

选对安装包,两分钟就能装完,Windows 上按权限三选一:

你的情况选哪个包
有管理员权限,整机统一装installer.exe:NSIS 安装器,装进 Program Files
没有管理员权限.msi:装到当前用户目录,免管理员
只想要解压即用的绿色版no-installer.exe:不注册文件类型关联

走微软商店的 APPX 版本(商店分发的打包格式)同样按用户安装、免管理员。

装完打开,界面就三块。左侧是形状库,顶部搜索框下面按 General 等分类排列,矩形、菱形直接拖进画布,点 "More Shapes..." 展开全部。中间是画布,支持无限缩放平移,底部页签让一个文件装下多个页面。右侧是属性面板,字体、纸张规格、连接点都在这里改。

新建文件时套用内置模板——流程图、UML、网络拓扑都有,常用的另存为个人模板以后复用。出第一张图:拖几个图形连上线,文件菜单选 Export As,格式、边距、缩放、透明背景各设一次即可。

一条命令批量转换图表 ⚡

装好的 draw.io 本身就是一条命令行工具(CLI,就是在终端里敲参数干活),整个目录的图可以递归转完,这是它比网页版强得多的地方。

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

-x打开导出模式,-r递归子目录,--transparent出透明底。单个文件同理:drawio -x --format pdf flow.drawio。高频参数就几个:-b 10四周留 10 像素,-s 2输出两倍尺寸,-a把多页合并进一份 PDF,--theme dark生成深色背景。输入也不局限于 .drawio——Visio 的 .vsdx、.csv、Mermaid 的 .mmd 文件直接丢进去就能转。

参数全集定义在 src/main/args.js,终端敲drawio -h可看全部帮助。

特殊环境适配:离线内网、关更新、本地数据目录

这些场景都有现成开关和固定路径,不需要动代码:

  • 离线与内网隔离:应用按隔离网络设计,所有脚本内置,内容安全策略(CSP,一条禁止远程脚本执行的浏览器规则)封死了外部 JS。唯一的网络请求是启动时的版本更新检查。注意一点:图表里若用 URL 嵌了外部图片、背景或字体,打开文件时会去请求那些地址,可能把你的 IP 暴露给对方。
  • 关闭更新检查:设环境变量DRAWIO_DISABLE_UPDATE=true,或启动时追加--disable-update;Flatpak 构建会自动关掉。
  • 本地数据:macOS 在~/Library/Application Support/draw.io,Windows 在C:\Users\<用户名>\AppData\Roaming\draw.io\;应用偏好(electron-store 持久化的小配置文件)也在同一处,迁移或清理数据认准这里。
  • 自构建:需要 Node 22.12 以上,编辑器本体是 git 子模块(drawio/目录),clone 必须带--recursive,缺了它项目打不开:
git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop && npm install && npm start

DRAWIO_ENV=dev会顺带打开 DevTools;个人 fork 构建时设DRAWIO_UNSIGNED=true跳过签名与公证,完整流程见 doc/BUILDING_FOR_PERSONAL_USE.md。项目不接受外部 PR,自构建版本仅供自用,更新方式变成"拉取—重新构建—重装"。

避坑清单 ⚠️:导出与安装的常见报错处理

新手最常碰的几个现象,原因和解法逐条对应,对号入座就行:

现象原因解法
图片导出只有第一页图片格式默认只导一页要其他页加-p 2这类页码参数;多页合并进 PDF 用-a
导出范围比预期小默认按图元内容裁剪(--size diagram--size page导出整页
透明背景没生效--transparent只对 PNG、SVG 有效,JPEG 本身无透明通道改导 PNG
自构建版启动后没生效单实例限制:第二个进程把新窗口交给了已运行的官方版先退出官方应用,再启动自构建版
macOS 按空格没有预览Quick Look(Finder 里按空格的文件快速预览)依赖签名,未签名的自构建版加载不了该扩展视为此功能不可用,直接打开应用查看

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

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

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

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

立即咨询