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),仅供参考