企业官网建设流程全解析

drawio-desktop 指南：Visio 文件跨平台转换与 3 种离线用法

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

drawio-desktop 是基于 Electron 的免费桌面图表应用（Apache 2.0 许可），它把 draw.io 核心编辑器打包成本地程序，主打 Visio 文件的跨平台编辑与转换。如果你手上有 .vsdx 文件、没有 Visio 授权，或者电脑不是 Windows，它就是为数不多的本地选项之一：无需上传文件，导入导出全程在本机完成。

能做什么，先说清边界

• 做得到：直接打开 .vsdx 文件并继续编辑；通过命令行把 Visio、drawio 文件批量导出为 PNG、SVG、PDF、JPEG、XML、HTML
• 做不到：不能把编辑结果写回 VSDX 格式（导出方向只有上述格式），也不是 Visio 的完整替代，Visio 专有高级特性不在覆盖范围内
• 注意：Linux 上它主要作为离线图表编辑工具和命令行转换器使用，图形界面体验以 Windows 和 macOS 为准

把预期放在这里，后面用起来不会踩空。

安装 drawio-desktop 的 2 种途径

普通用户不需要编译。官方 release 页面提供各平台的预编译安装包；其中 Windows 分三种形态，按权限选一个即可：

• MSI 安装包：装在用户目录，不需要管理员权限，权限不足时优先选它
• NSIS 安装程序：装到 Program Files，需要管理员权限
• 便携版 exe：解压即用，不注册文件关联

从源码构建只建议个人使用：

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

设置DRAWIO_UNSIGNED=true后执行npm run release-win可产出未签名安装包，流程细节见 doc/BUILDING_FOR_PERSONAL_USE.md。

Visio 文件转 drawio：导入与首次保存

结果：打开 .vsdx 后，图形、样式与页面结构会保留下来，此后可以像普通 drawio 文件一样编辑、保存，不再依赖 Visio。

操作路径只有三步：

1. 双击 .vsdx 文件，或在菜单里选 File → Open 打开它
2. 按需修改内容
3. 另存为 .drawio 文件，之后所有编辑都基于这个新格式

如果不想保留可编辑文件，也可以在 File → Export 里直接输出 PNG 或 PDF，跳过保存步骤。

批量把 VSDX 导出为 PNG

结果：一个文件夹里成百上千个 Visio 文件，一条命令全部转成图片，可以交给脚本或 CI 流程。

drawio-desktop 自带 CLI 导出，支持 .drawio、.vsdx、csv 和 Mermaid 输入：

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

几个常用开关：

• --recursive：连子目录一起递归转换
• --page-range 1..3：只导出第 1 到 3 页（PDF 格式有效）
• --check：已有同名输出文件时跳过，不覆盖

批量导出时输出参数要写成目录；多个文件导到同一个文件名会被逐个覆盖，这是最常见的坑。

离线环境配置 drawio-desktop

结果：图表数据全程不出本机，默认不上传任何内容；唯一例外的自动更新检查可以彻底关闭。

关闭更新检查，任选其一：设置环境变量DRAWIO_DISABLE_UPDATE=true，或启动时追加--disable-update。受管环境里建议用环境变量，一劳永逸。

一个容易忽略的点：图表内容本身不外发，但如果 .vsdx 或 .drawio 文件里嵌入了外部地址（网络图片、在线字体等），打开时会向这些 URL 发起请求——不会发送图表内容，但可能暴露你的 IP。处理来路不明的文件时留意一下。

对比：在线转换工具、原生 Visio 与 drawio-desktop

选型建议一句话：数据要留本机、且需要批量处理，选桌面版；只是偶尔转一两张图，在线工具也能应付。

数据安全与常见坑，一次说清

• 敏感图表别走在线转换，本地 CLI 导出是最短路径；应用的内容安全策略（CSP）也禁止加载远程脚本
• 导出整张多页图时记得--all-pages，否则 PDF/HTML 可能只含首页，图片格式默认只导第一页
• 大型 Visio 文件若打开卡顿，先用 CLI 转成 PNG 或 PDF 再分发，不必让每个人都装编辑器
• 构建、发版、个人 fork 的细节看 doc/ 和 src/main/，与日常使用无关

行动建议：下载对应平台的安装包，拿一个真实的 Visio 文件走一遍「导入 → 另存 → 导出」，确认样式与页面结构符合预期，再把它放进团队流程。

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