draw.io 桌面版完整指南：免费跨平台的 VSDX 导入与批量导出工具
【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop
draw.io 桌面版（drawio-desktop）是基于 Electron 的开源桌面绘图应用，封装了在线绘图工具 draw.io（现名 Diagrams.net）的核心编辑器。它遵循 Apache 2.0 协议、可免费商用，支持 Windows、macOS 与 Linux 三个平台，能够本地打开 Visio VSDX、CSV、Mermaid 等文件，并把图表导出为 PDF、PNG、SVG 等格式。
draw.io 桌面版安装与启动
如果只是日常使用，直接从项目的 release 页面下载对应平台的二进制包即可。Windows 上发布三种包，选型取决于是否有管理员权限：
| Windows 包 | 安装方式 | 是否需管理员权限 |
|---|---|---|
| NSIS 安装包（.exe） | 整机安装到 Program Files | 需要 |
| MSI 包（.msi） | 按用户安装 | 不需要 |
| 便携版（no-installer .exe） | 免安装直接运行 | 不需要，但不注册文件关联 |
macOS 提供标准应用包，Linux 提供 AppImage、deb、rpm 等格式。若希望从源码构建（例如修改默认行为），需要 Node.js 22.12 及以上版本。注意核心编辑器以 git 子模块形式存放在仓库中，必须递归克隆，否则drawio目录为空、应用无法加载界面：
git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install安装完成后，在仓库根目录启动：
npm start窗口打开后就是完整的编辑界面：左侧形状库、中央画布、右侧属性面板，全部本地加载，无需登录。启动后可直接使用下面这三项能力。
三个最值得上手的核心能力
在应用的全部功能里，使用频率最高的是导入、导出和版本更新，分别适合不同的使用者。
离线导入多种格式。除 draw.io 自身的 XML 文件外，应用可以直接打开 VSDX、CSV、Mermaid 文件，导入后的形状与连接线保持可编辑状态。适合经常收到 Visio 文件、但本机没有 Office 的用户。上手建议：先拿一份真实 VSDX 打开，对照原文件检查形状映射和文本还原度，再决定是否纳入团队工具链。
命令行批量导出。全部命令行参数定义在 src/main/args.js 中，--export可以一次导出指定文件或整个目录，输出格式支持 pdf、png、jpg、svg、xml、html，还能指定页面、图层与边距。适合需要把图表纳入文档流水线的开发者和文档维护者。上手建议：多页文档搭配--all-pages一次输出完整 PDF，避免逐页导出。
自动更新与本地数据。应用启动时会检查是否有新版本，可以通过环境变量DRAWIO_DISABLE_UPDATE=true或启动参数--disable-update关闭检查；设置与缓存都存在本地目录（macOS 为~/Library/Application Support/draw.io，Windows 为%APPDATA%\draw.io\）。适合对版本一致性有要求的 IT 管理员。上手建议：企业统一部署时固定版本并关闭自动更新，再配合内部发布流程。
把这三项能力串起来，就是一条完整的日常工作流。
工作流走查：从收到 VSDX 文件到交付 PDF
以"收到一份 Visio 流程图，编辑后交付 PDF"为例：
- 打开文件：通过文件菜单打开 VSDX，或直接用命令行传入文件路径。预期结果：形状、连接线和文本被解析到画布上，原有连接关系保留，可缩放查看细节。
- 编辑调整：修改某个形状的样式、拖拽位置，或从形状库新增组件。预期结果：画布即时反映改动，支持撤销与重做。
- 导出交付物：在导出对话框中指定 PDF 格式。预期结果：生成文件；多页文档需确认包含全部页面。
- 抽查核对：打开 PDF 与画布比对字体、线宽和分页。预期结果：排版一致；若图片清晰度不足，可提高导出质量参数后重新生成。
同样的流程换成 PNG 或 SVG 输出，只是最后一步的格式参数不同。
进阶：draw.io 桌面版的网络隔离与更新控制
处理敏感数据的用户，可以重点关注这个项目的安全设计。应用默认与网络完全隔离，唯一的出站行为是启动时的更新检查；所有 JavaScript 均为自包含文件，内容安全策略禁止加载远程脚本，应用因此无法上传图表或发送任何使用数据。一个需要注意的例外：图表内若引用了外部图片或字体，打开时会去请求对应地址，所以打开不可信来源的图表可能暴露你的 IP，但不会发送图表内容。
集中部署时，用环境变量或--disable-update参数关闭更新检查，应用即可完全离线运行。如果想修改代码构建私有版本，项目虽然不接受外部贡献，但 Apache 2.0 协议允许自由 fork 并本地构建，未签名构建的完整步骤见 doc/BUILDING_FOR_PERSONAL_USE.md。
常见问题
问：断网的机器上应用能正常运行吗？答：能。除启动时一次更新检查外不依赖任何网络，关闭该检查后可完全离线使用。唯一受影响的是图表内引用的外部图片和字体无法加载。
问：为什么克隆仓库必须带--recursive参数？答：核心编辑器是该项目的 git 子模块，不递归克隆时drawio目录为空，应用启动后界面无法加载。已普通克隆过的仓库可用git submodule update --init补齐。
问：商用场景收费吗？答：不收费。项目采用 Apache 2.0 开源协议，只要不修改代码并接受按原样提供的条款，即可用于任何用途。
问：源码运行版本如何升级？答：不需要重新克隆，拉取新代码、执行npm install后再次npm start即可；源码运行不走安装包的更新通道。
无论是要处理同事发来的 VSDX，还是为文档批量生成配图，这套免费工具在三个平台上的行为一致，数据也始终留在本机。遇到具体问题，可先查仓库 README 中的 Support 一节与发布说明。
【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
