企业官网建设流程全解析

drawio-desktop：免费转换 VSDX 的 3 步安装与离线批量导出指南

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

drawio-desktop 是 draw.io 的官方 Electron（跨平台桌面应用框架）构建版，基于 Apache 2.0 协议免费使用，不需要任何 Visio 授权。它在本地完成流程图的绘制、编辑，以及 VSDX、CSV、Mermaid 等图表文件的导入与导出。适合三类人：想脱离 Visio 授权成本画流程图的工程师、需要离线处理敏感图表的安全敏感团队、以及有大量图表文件要批量转换格式的人。

它替代了什么

• Visio 需要购买授权，且只能在 Windows 上运行；drawio-desktop 免费，Windows、macOS、Linux 都支持。
• 在线转换工具要求先把文件上传到对方服务器，涉密图表无法使用；drawio-desktop 的所有渲染和导出都在本机完成。
• 不同平台的 draw.io、VSDX、CSV 文件互相打不开或需要逐页手工转；它把这些格式纳入同一套导入导出流程。
• 给一组文件统一转成 PNG、PDF 时，逐个打开再截图的做法无法批量执行；它提供命令行导出。

三步完成 drawio-desktop 的安装与启动

1. 克隆仓库，必须带--recursive参数：编辑器本体是 git 子模块，漏掉它构建会失败。
2. 安装依赖。源码构建需要 Node.js 22.12 以上版本（Electron 是运行时外壳，Node.js 负责跑它的打包脚本）。
3. 启动应用，启动参数里可以追加--enable-logging打开日志便于排查问题。

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

如果不想自己构建，也可以直接下载官方发布页的二进制安装包。Windows 上有三种形态：-windows-installer.exe（NSIS 安装器，装到 Program Files，需要管理员权限）、.msi（用户级安装，不需要管理员权限）、-windows-no-installer.exe（绿色便携版，解压即用但不注册文件关联）。

🖼️ 日常绘图：三栏界面各管什么

上图是启动后的默认界面，分三栏：

• 左侧形状库：顶部Search Shapes输入框可按名称搜形状，下面按分类列出矩形、圆、箭头、UML 符号等，直接拖进画布。
• 中央画布：默认带网格便于对齐，底部Page-1标签支持多页文档，加号新建页面。
• 右侧属性面板：网格开关、背景、连接点、辅助线、Autosave（自动保存）以及纸张尺寸和方向。

📤 批量导出命令怎么写

命令行入口支持--export选项，可以对文件列表或整个目录做转换，不打开图形界面逐个操作：

drawio --export diagrams/ -o out/ --format png --recursive

• 输入可以是目录，--recursive表示连子目录里的文件也一起转换；
• 导出格式支持 pdf、svg、png、jpeg、xml、html，默认 pdf，指定输出扩展名时以扩展名为准；
• --page-index按页码选某一页，--page-range用起始..结束指定页段（仅 PDF）；
• --layout verticalFlow等参数可在导出前对图表自动重新布局，可选 verticalFlow、horizontalTree、organic 等预设。

🔁 VSDX 与多种格式怎么互转

除 draw.io 自身格式外，--export同样接受 VSDX、CSV、Mermaid（.mmd/.mermaid）文件作为输入；输出可选 png、jpeg、svg、pdf、xml、html。典型路径：Visio 存的 .vsdx 双击打开 → 编辑 → 导出 SVG 或 PDF 分发给同事；Mermaid 文本图表则直接转成可嵌入文档的图片。

关于数据安全，官方把隔离作为首要设计目标：除启动时的版本更新检查外不与互联网通信，所有 JavaScript 内置，内容安全策略（CSP，浏览器用来限制页面能加载哪些资源的机制）禁止远程加载脚本，图表数据不会外发。要完全关掉更新检查，设置环境变量DRAWIO_DISABLE_UPDATE=true或启动时加--disable-update即可。注意一点例外：如果图表里本身嵌了外部图片的 URL，打开时会去拉取这些资源，所以谨慎打开来源不明的文件。

选型对比：本地桌面 vs 在线转换 vs Visio

常见问题

Q：.vsdx 文件直接双击能打开吗？安装版应用注册了文件关联，可以。绿色便携版不注册文件关联，需要手动拖入窗口或走命令行。

Q：公司电脑没有管理员权限，装不了？选 MSI 安装包（用户级安装，不需要管理员权限）或绿色便携版；NSIS 安装器才需要管理员权限。

Q：内网环境完全不能联网，导出会失败吗？不会。渲染和导出全程本地执行，建议顺手用--disable-update关掉更新检查，避免启动时尝试联网。

Q：导出的 PDF 只想包含第 2 到第 5 页？加--page-range 2..5，该选项只对 PDF 格式生效，页码从 1 开始。

写在最后

一句话总结：drawio-desktop 把 draw.io 装进了离线桌面应用，免费完成绘图、VSDX 互转和批量导出。行动建议：按本文「三步完成安装」一节先跑起来，然后挑一个现成的 .vsdx 文件用--export命令试一次转换。需要修改构建或自行打包的，参考仓库内的 doc/BUILDING_FOR_PERSONAL_USE.md，主程序入口在 src/main/。

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