drawio-desktop 离线流程图桌面工具指南:本地编辑与命令行批量导出 📅 发布时间:2026/9/6 15:44:01 👁 浏览次数: drawio-desktop 离线流程图桌面工具指南本地编辑与命令行批量导出【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktopdrawio-desktop 是基于 Electron 的免费开源画图桌面应用内置 draw.io 完整编辑器支持流程图、UML 等图表的本地创建与编辑可通过命令行把 drawio、Visio.vsdx、CSV、Mermaid 文件批量导出为 PDF、PNG、SVG 等格式。适合需要离线处理敏感图表、在非 Windows 系统上打开 Visio 文件、或做批量格式转换的开发者与文档维护者。先看它适合谁处理敏感图表的团队应用默认不与互联网通信除启动时的更新检查图表数据不会上传到任何服务器适合内网环境或合规要求高的场景。使用 Visio 文件的非 Windows 用户macOS、Linux 用户没有 Visio可以用它打开 .vsdx 文件并在本地上查看、编辑。需要批量转换的人命令行接口支持递归处理整个文件夹一次把大量文件导出成图片或 PDF省去逐个手动操作。不想为画图软件付费的个人项目在 Apache 2.0 许可下提供不改代码直接使用的情况下可自由用于任何目的。最快上手路径先确认环境源码构建需要 Node.js 22.12 以上官方构建使用 Node 24和 npm。如果只是想用现成的应用从 releases 页面下载对应平台的安装包即可从源码运行则按下面步骤走。拉取项目核心编辑器 drawio 是一个 git 子模块必须递归克隆否则启动后界面没有内容git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop安装依赖并启动npm install npm start启动后会自动打开桌面窗口进入熟悉的 draw.io 编辑器左侧是形状库中间是绘图区右侧是格式属性面板。需要调试时可以用npm start --enable-logging打开日志输出设置DRAWIO_ENVdev会自动打开 DevTools。用一个真实任务理解主流程命令行导出 PDF假设手头有一个flow.drawio文件想离线生成一份可分发的 PDF不需要打开界面操作。在终端执行drawio flow.drawio --export -f pdf -o flow.pdf -b 10--export触发导出-f pdf指定目标格式默认就是 pdf-o指定输出路径-b 10给图表四周留出 10 像素边距。执行完成后当前目录会出现flow.pdf。如果目录里放了一堆文件想一次性转换把输入换成文件夹并加--recursivedrawio ./diagrams --export -f png -o ./out --recursive整个文件夹含子目录下的图表会被递归导出为 PNG文件名沿用原始输入名。参数以应用自带帮助为准不带参数运行drawio --help可以看到完整选项表。关键能力拆解输入不只认 drawio 自家格式导出功能接受的输入除 .drawio 外还包括 .vsdxVisio、.csv 和 Mermaid.mmd/.mermaid。对 Mermaid 文件可以用--mermaid-image让它按静态图片而非可编辑图表打开。输出六种格式加一组实用开关支持 pdf、png、jpg、svg、xml、html 六种导出格式-f参数校验白名单。常用的控制项包括--page-index/--page-range指定页码或页范围页范围仅对 PDF 生效--all-pagesPDF 和 HTML 导出全部页面--size diagram|page按图表内容裁剪或导出完整页面--transparent、--scale、--width、--height透明背景、缩放、限宽限高--embed-diagram在 PNG/SVG/PDF 中嵌入图表副本导出物仍可回读编辑本地处理与安全边界界面与脚本全部内置CSP 策略禁止远程加载 JavaScript也没有任何使用统计上报。需要更新检查的完全离线环境可设置环境变量DRAWIO_DISABLE_UPDATEtrue或启动时加--disable-update。唯一要注意的是图表如果内嵌了来自 URL 的图片、背景或字体打开文件时仍会向该地址发起请求不发送图表内容打开来源不明的文件时留意这一点。平台覆盖发布产物覆盖 Windows x64/ARM64、macOS 13 以上、LinuxAppImage、deb、rpm、snap。32 位 Windows 已不再提供构建。常见卡点与处理办法npm start 启动后界面空白或报错通常可先检查是否漏了--recursive没有子模块时drawio/目录是空的编辑器自然加载不出来。补救办法是在仓库根目录执行git submodule update --init再重新启动。本地构建启动后新窗口跑在官方安装版里draw.io 每个用户只允许一个运行实例。如果官方应用正在运行你的本地构建启动后只会在官方应用里开一个新窗口。建议先彻底退出已安装的 draw.io再启动自己的版本。个人构建被自动更新悄悄覆盖从源码或 fork 构建的版本会默认走官方自动更新通道运行后可能被替换回官方版本。构建个人版前执行npm run sync -- disableUpdate关闭更新具体流程可参考 doc/BUILDING_FOR_PERSONAL_USE.md。Visio 文件打开后样式与 Windows 上不一致.vsdx 本质是压缩包其中部分元素依赖 Visio 专有定义转换到 draw.io 后个别样式、连接点可能出现偏差。建议先确认核心信息形状、连线、文字是否完整再决定是否手工微调。边界、限制与适合场景客观地说drawio-desktop 的定位是“本地的个人编辑与转换工具”而不是团队协作平台它是单用户桌面应用没有内置多人实时协作或云端同步团队共享图表文件可以借助 Git 等版本工具自行组织。项目长期不接受外部贡献修改只能走 fork 自建路线个人构建未经签名macOS Gatekeeper 与 Windows SmartScreen 会给出提示。对大型文件的处理上限仓库没有给出量化指标批量处理前建议小范围试跑。选择维度drawio-desktop在线转换工具商业 Visio图表数据去向保留在本地需上传到服务端保留在本地支持系统Windows / macOS / Linux有浏览器即可仅 Windows授权成本免费Apache 2.0依服务而定需购买授权批量转换内置命令行依赖平台能力主要靠界面操作下一步建议先下载官方安装版跑通一次“打开 .vsdx → 导出 PNG”的完整链路确认格式满足需求再考虑从源码构建。做批量转换前用 2、3 个有代表性的文件含多层、多页、含外部图片的试跑--export核对输出再上量。内网部署时设置DRAWIO_DISABLE_UPDATEtrue避免启动时的版本检查。若需定制按 doc/BUILDING_FOR_PERSONAL_USE.md 的流程设置DRAWIO_UNSIGNEDtrue构建个人版本并留意它不受官方支持。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考