drawio-desktop:VSDX 双向互通,一条命令批量导出整目录图表
2026/9/2 12:36:25 网站建设 项目流程

drawio-desktop:VSDX 双向互通,一条命令批量导出整目录图表

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

.vsdx流程图来自 Windows 上 Visio 用户,到了 Mac 和 Linux 往往是打不开的文件,或一张拍扁后动不了的图片。drawio-desktop(draw.io 官方 Electron 桌面版)解决的就是这件事:原生读写 VSDX,形状和图层原样保留,还自带命令行批量导出。免费,Apache 2.0 许可,当前版本 31.3.2,三大平台都能跑。

先搞清楚它到底能做什么

  • 打开并编辑.drawio.vsdx.csv和 Mermaid(.mmd/.mermaid)文本
  • 导出为 pdf、png、jpg、svg、xml、html
  • CLI 递归处理整个文件夹,批量输出
  • 默认离线,只有版本检查会联网且可关闭;窗口尺寸位置本地保存

五分钟上手:两种拿法,挑一种

只用的话,去发布页拿对应系统的安装包,Windows 有 NSIS 安装版、MSI、免安装便携版三种。要改启动行为或窗口逻辑,才走源码构建:

git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm start

--recursive别省:核心编辑器是 git submodule,缺了构建直接失败,对着报错日志发呆的是你。Node 需要 22.12.0 以上,源码构建细节见 doc/BUILDING_FOR_PERSONAL_USE.md。

启动后第一眼是三栏布局:左形状库、中画布、右属性面板。

真正拉开差距的那一个功能:VSDX 双向读写

从 Visio 用户手里接过.vsdx的人都知道窘境:商业授权锁在 Windows,免费在线转换又把图拍成图片——图层没了、样式乱了,到手即不可编辑。drawio-desktop 把 VSDX 解析成真实可编辑对象:每个形状、连线、图层分组、颜色样式都能单独选中修改,和原图体验一致。

反方向同样成立。我们画的.drawio能存回 VSDX,Windows 同事打开发现样式没乱、连线没断,接着改。样式和连接关系双向走都不丢。

操作就三步:双击或把.vsdx拖进窗口;打开后点任意图形,确认是可选中对象再改文本和颜色;导出时选 VSDX 格式发回给对方。全程不碰 Visio。注意 CLI 的-f格式列表(pdf、png、jpg、svg、xml、html)里没有 vsdx,VSDX 到 VSDX 的往返还得走图形界面。

剩下那些也值得知道:CLI 批量导出与离线模式

  • 批量导出像条流水线:
drawio -x -f png -r -o ./exported ./diagrams

递归把整个目录的图转成 PNG。-x导出模式,-f格式,-r递归子目录,-o输出目录;做 PPT 配图加--transparent透明底、--width 1200控制尺寸(参数定义在 src/main/args.js)。

  • 默认不联网,唯一外发请求是版本检查。内网机器设环境变量DRAWIO_DISABLE_UPDATE=true或启动加--disable-update彻底关闭,界面 CSP 还禁止加载远程 JavaScript。
  • CSV 和 Mermaid 也能当输入直接打开,文本画的时序图、Excel 里的表格都能汇进同一张图。

把它嵌进团队日常的两条建议

.drawio是纯 XML 文本,进仓库后 diff 可读。我们的做法是提交前跑一次git diff -- '*.drawio',看谁挪了哪个框、改了什么色,图表评审和代码评审同一场过,"最终版_v2_真的最终"系列文件就此退休。

个人效率侧,多显示器用户把窗口记忆用起来:尺寸和位置本地保存,关窗再开会自动落回上次的显示器(src/main/window-bounds.js 里还处理了拔线后的兜底居中),每天省一次手动拖窗。

谁适合用,谁可以不用

三类人收益最直接:Windows 上有 Visio 存量且同事跨平台协作的团队;需要批量生成文档和 PPT 配图的工程师;对数据出网有硬性要求的内网团队,图不离开本机。

两类人可以不折腾:全员 Windows、只画简单流程图的团队,Visio 免费档够用;想要多人同时在线编辑的,桌面版是单机应用,替代不了共享白板。

如果你正被一份打不开的.vsdx或一整个待转换的图表目录卡住,打开终端执行git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop,按上面步骤启动,把文件拖进去就行。

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

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

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

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

立即咨询