企业官网建设流程全解析

draw.io 桌面版安装与 Visio 文件批量转换图片完整指南

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

同事发来的 .vsdx 文件，双击却没人能打开。draw.io 桌面版（drawio-desktop）是一个基于 Electron 的开源画图工具，Apache 2.0 协议免费，全程离线可用。它能打开 Visio 的 .vsdx 文件继续编辑，也能用一条命令把图表批量转成 PNG、PDF 等格式。

按权限安装 draw.io 桌面版

Windows 发布三种安装包（见 README.md），按你在电脑上的权限挑一种：

macOS 和 Linux 从官方发布页下载对应安装包即可。装好后直接双击.drawio或.vsdx文件就能启动应用。

从源码运行（普通用户可跳过）

仅开发者需要。必须带--recursive：编辑器核心是 git 子模块，少了它构建直接失败，说明见 doc/BUILDING_FOR_PERSONAL_USE.md。

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

把 Visio 文件转进 draw.io 里编辑

先说边界：VSDX 只进不出——能打开、能改，但写不回 .vsdx；.vsd 旧格式也不支持，让发送方先另存为 .vsdx。

界面方式：双击 .vsdx 文件，解析在后台完成（入口在 src/main/electron.js），打开后就是普通可编辑图表，多页 Visio 文件对应成多个页面。

命令行方式，不打开窗口直接转换：

drawio 方案.vsdx --export --format png --output 方案.png

三点结果说明：

• 形状、文字、连线基本保留，但 Visio 专有部分形状和样式可能走样，交付前抽查一遍
• 多页文件只导出第一页，选页见下文
• 流程图、泳道图这类常规图可以放心主力使用；涉及数据绑定等 Visio 专有功能的，逐张核对

批量导出整个文件夹的图表

这条命令把一个目录里的图全转成 PNG：

drawio ./diagrams --export --format png --output ./exported --recursive

三点结果说明：

• --recursive连子目录一起扫；不加就只转当前层
• 输入多个文件时，--output必须是文件夹——多个文件写进同一个文件会被应用直接拒绝
• 加--check不会覆盖已存在的输出文件，脚本可以反复跑

CSV 和 Mermaid（.mmd/.mermaid）也能作为命令行输入：CSV 直接渲染成表格图形，Mermaid 由代码生成图表。

导出单页、图层和布局：最常用参数

只列最常用的 8 个，完整清单在 src/main/args.js：

• --export（-x）：触发导出。所有转换命令都要带
• --format（-f）：格式。pdf、png、jpg、svg、xml、html，默认 pdf；--output带扩展名时以扩展名为准
• --output（-o）：输出文件或文件夹；省略则用输入文件名命名
• --recursive（-r）：文件夹输入时递归子目录
• --check（-k）：已存在的输出文件不覆盖
• --page-index（-p）：导出图片时选某一页，1 起始
• --layers（-l）：只导出指定图层，逗号分隔
• --layout：导出前套用内置布局（verticalFlow、horizontalTree 等），把凌乱的图先摆整齐再出图

两个默认行为值得知道：默认输出裁到图内容的尺寸，要整页输出加--size page；-t给 PNG/SVG 透明背景，-b调边距。参数的边界行为（比如1..3怎么解析）在测试文件 src/test/cli-args.test.js 里都有覆盖，写法拿不准时查那里。

draw.io 桌面版、在线转换、Visio 怎么选

选择逻辑：文件不想离开本机、或要跑在 Linux/macOS 上，选桌面版；一次性转换且内容不敏感，在线工具就够；对方流程必须写回 .vsdx，仍得用 Visio 本体。

本地数据存哪，怎么彻底离线

图表数据从不外发，应用唯一的外部请求是启动时的版本检查（src/main/electron.js）。会话和本地数据存放在：

• Windows：C:\Users\<用户名>\AppData\Roaming\draw.io
• macOS：~/Library/Application Support/draw.io
• Linux：~/.config/draw.io

图表本身在你保存的文件里，备份跟着文件走。彻底离线：设置环境变量DRAWIO_DISABLE_UPDATE=true，或启动时加--disable-update，之后应用不再发任何更新请求。

一条安全提醒：图表可以内嵌 URL 形式的图片、字体资源，打开不可信来源的文件时会向这些 URL 发请求——不传图表内容，但可能暴露你的 IP 等网络信息，来路不明的文件谨慎打开。

第一天就用起来的三件事

1. 转换一个 .vsdx：跑第二节的--export --format png命令，把输出 PNG 和原图并排打开，确认形状和连线保真。
2. 批量导出写进脚本：对文档目录执行drawio ./docs --export --format png --output ./exported --recursive --check，重跑一次，确认已有文件没被覆盖（文件时间戳不变）。
3. 关掉版本检查：以--disable-update参数启动，观察应用不再发起更新请求，确认完全离线可用。

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