draw.io 桌面版完整指南3 步跑起来免费导入 VSDX 并离线导出【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop同事发来一个 .vsdx 的 Visio 流程图macOS 或 Linux 上却没有软件能打开它。draw.io 桌面版是基于开源 draw.io 编辑器构建的 Electron 应用可以离线导入 VSDX 文件并编辑再导出为 PDF、PNG、SVG 等格式基于 Apache 2.0 协议完全免费。 项目定位drawio-desktop 是什么它是 draw.io 的官方 Electron 桌面构建核心编辑器以 git 子模块内嵌应用外壳负责窗口、菜单、文件对话框和命令行导出。支持 Windows、macOS、Linux 三个平台。相比在线版它带来的直接变化无需登录、无需上传打开后所有绘图都在本机完成直接导入 VSDX、CSV、Mermaid 文件导出 PDF/PNG/SVG/XML/HTML命令行批量导出可以写进 CI 或文档流水线唯一的联网行为是启动时的更新检查可完全关闭编辑器通过子模块随版本更新功能与网页版保持一致 快速上手3 条命令跑起 drawio-desktop环境要求是 Node.js 22.12 或更高官方 CI 用 Node 24版本过低会在安装依赖时直接报 engine 错误。第一步下载源码。注意--recursive编辑器核心是子模块漏掉它drawio/目录会是空的git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop第二步安装依赖cd drawio-desktop npm install第三步启动应用npm start窗口正常打开就算成功。需要排查问题时用npm start --enable-logging让主进程把更多日志打到终端。⚙️ 核心机制数据凭什么不出本机隔离是这个项目的第一设计目标。网页部分的 Content Security Policy 禁止执行远程加载的 JavaScript应用自身的网络连接也被限制为只能指向自己图表内容在物理上没有外发通道。唯一的例外是启动时检查一次新版本用环境变量DRAWIO_DISABLE_UPDATEtrue或启动参数--disable-update即可关闭。编辑器与外壳的交互走的是受限 IPC 桥渲染进程只能用src/main/electron-preload.js通过 contextBridge 暴露的白名单 API主进程侧再用validateSender()校验请求确实来自本地页面防止嵌入内容借系统文件对话框等接口越权。VSDX 本质是一个 ZIP 包导入解析也全部发生在本地主进程打开一个隐藏窗口加载vsdxImporter.html把文件字节经 IPC 送进去编辑器的导入逻辑跑完后把 draw.io XML 交回主进程。走命令行导出时这一步不弹任何窗口直接进导出流程。全部参数定义在 src/main/args.js支持批量、递归、按页导出等选项。运行数据同样落在可预期的位置平台存储位置macOS~/Library/Application Support/draw.ioWindowsC:\Users\用户名\AppData\Roaming\draw.io 实操走查VSDX 导入、编辑到批量导出以“收到同事的 VSDX转成 PDF 放进汇报材料”为例。终端命令名是drawioWindows 安装目录下的drawio.exe如果你在用源码方式运行把它替换成npm start --。第一步打开文件操作在应用里 File → Open选中那个 .vsdx。 你会看到形状、连线、文字都被转成可编辑的 draw.io 元素拖拽、改色、加新形状都和原生文件没有区别。第二步单文件导出操作drawio -x 网络拓扑.vsdx --format pdf你会看到源文件同目录生成网络拓扑.pdf导出完成后应用自动收尾。第三步批量导出操作drawio -x diagrams/ --output out/ --recursive -f png你会看到diagrams/及子目录里所有 .drawio、.vsdx、.csv、.mmd 文件被逐个导出到out/扫到的非图表文件会被跳过并打印日志。注意--output在导出多个文件时必须指向目录写成单个文件会直接报错。第四步防覆盖、可回改操作追加--check不覆盖已有文件追加-e把图表副本嵌入导出产物。 你会看到目标文件已存在时生成带序号后缀的新文件嵌了副本的 PNG/PDF 之后还能被 draw.io 重新打开继续编辑。 选择参考和在线版、Visio 怎么选维度draw.io 桌面版在线版diagrams.netMicrosoft Visio平台Windows / macOS / Linux任意浏览器仅 Windows成本免费Apache 2.0基础免费高级功能付费付费订阅网络依赖完全离线更新检查可关必须联网文件可上云可离线VSDX导入导出支持导入支持有限原生批量导出内置 CLI不支持有限可定制性开源可 fork 构建固定固定适合谁在 macOS/Linux 上经常收到 Visio 文件的用户图表涉密、不能走云端的企业团队需要脚本化、可重复导出流水线的工程师。不适合谁依赖 Visio 专业图形库和模板生态的重度用户需要多人实时协同编辑的场景——桌面版没有在线协作。另外项目不接收外部 PR要深度二次开发请看下面收尾部分的个人构建文档。️ 踩坑记录5 个高频问题1. 启动后空白页或直接报错原因clone 时漏了--recursivedrawio/编辑器核心目录是空的。 处理在仓库根目录执行git submodule update --init再npm start。2. npm install 报 engine 相关错误原因Node 低于 22.12这是package.json里engines写死的下限。 处理把 Node 升到 22.12 以上再重装依赖。3. 内网环境启动慢或提示更新失败原因设计上启动时会连接官方发布源检查一次版本。 处理设环境变量DRAWIO_DISABLE_UPDATEtrue或启动时加--disable-update集中管控的部署建议统一关闭。4. 批量导出后只看到一个文件或直接报错原因--output指向了单个文件后面的文件会逐个覆盖前面的结果。 处理--output指向目录单文件输出只允许单个输入。5. 打开某个图表时观察到对外请求原因图表本身引用了外部资源——图片、背景或字体嵌着 URL打开时应用会按需抓取以便正常渲染。 处理只打开可信来源的图表文件README.md 的 Security 一节对这个行为有明确说明。 收尾现在就能做的三件事装好官方版本或用上面的 3 条命令跑起源码打开第一个 VSDX 并导出 PDF给自己团队的 diagrams 目录写一条批量转换命令放进 CI 或文档流水线内网环境提前用DRAWIO_DISABLE_UPDATEtrue关掉更新检查避免无谓的等待想继续深入安装与安全设计见 README.md个人无签名构建流程见 doc/BUILDING_FOR_PERSONAL_USE.md全部 CLI 参数看 src/main/args.js配套解析测试在src/test/目录。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 draw.io 桌面版完整指南：3 步跑起来，免费导入 VSDX 并离线导出
draw.io 桌面版完整指南3 步跑起来免费导入 VSDX 并离线导出【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop同事发来一个 .vsdx 的 Visio 流程图macOS 或 Linux 上却没有软件能打开它。draw.io 桌面版是基于开源 draw.io 编辑器构建的 Electron 应用可以离线导入 VSDX 文件并编辑再导出为 PDF、PNG、SVG 等格式基于 Apache 2.0 协议完全免费。 项目定位drawio-desktop 是什么它是 draw.io 的官方 Electron 桌面构建核心编辑器以 git 子模块内嵌应用外壳负责窗口、菜单、文件对话框和命令行导出。支持 Windows、macOS、Linux 三个平台。相比在线版它带来的直接变化无需登录、无需上传打开后所有绘图都在本机完成直接导入 VSDX、CSV、Mermaid 文件导出 PDF/PNG/SVG/XML/HTML命令行批量导出可以写进 CI 或文档流水线唯一的联网行为是启动时的更新检查可完全关闭编辑器通过子模块随版本更新功能与网页版保持一致 快速上手3 条命令跑起 drawio-desktop环境要求是 Node.js 22.12 或更高官方 CI 用 Node 24版本过低会在安装依赖时直接报 engine 错误。第一步下载源码。注意--recursive编辑器核心是子模块漏掉它drawio/目录会是空的git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop第二步安装依赖cd drawio-desktop npm install第三步启动应用npm start窗口正常打开就算成功。需要排查问题时用npm start --enable-logging让主进程把更多日志打到终端。⚙️ 核心机制数据凭什么不出本机隔离是这个项目的第一设计目标。网页部分的 Content Security Policy 禁止执行远程加载的 JavaScript应用自身的网络连接也被限制为只能指向自己图表内容在物理上没有外发通道。唯一的例外是启动时检查一次新版本用环境变量DRAWIO_DISABLE_UPDATEtrue或启动参数--disable-update即可关闭。编辑器与外壳的交互走的是受限 IPC 桥渲染进程只能用src/main/electron-preload.js通过 contextBridge 暴露的白名单 API主进程侧再用validateSender()校验请求确实来自本地页面防止嵌入内容借系统文件对话框等接口越权。VSDX 本质是一个 ZIP 包导入解析也全部发生在本地主进程打开一个隐藏窗口加载vsdxImporter.html把文件字节经 IPC 送进去编辑器的导入逻辑跑完后把 draw.io XML 交回主进程。走命令行导出时这一步不弹任何窗口直接进导出流程。全部参数定义在 src/main/args.js支持批量、递归、按页导出等选项。运行数据同样落在可预期的位置平台存储位置macOS~/Library/Application Support/draw.ioWindowsC:\Users\用户名\AppData\Roaming\draw.io 实操走查VSDX 导入、编辑到批量导出以“收到同事的 VSDX转成 PDF 放进汇报材料”为例。终端命令名是drawioWindows 安装目录下的drawio.exe如果你在用源码方式运行把它替换成npm start --。第一步打开文件操作在应用里 File → Open选中那个 .vsdx。 你会看到形状、连线、文字都被转成可编辑的 draw.io 元素拖拽、改色、加新形状都和原生文件没有区别。第二步单文件导出操作drawio -x 网络拓扑.vsdx --format pdf你会看到源文件同目录生成网络拓扑.pdf导出完成后应用自动收尾。第三步批量导出操作drawio -x diagrams/ --output out/ --recursive -f png你会看到diagrams/及子目录里所有 .drawio、.vsdx、.csv、.mmd 文件被逐个导出到out/扫到的非图表文件会被跳过并打印日志。注意--output在导出多个文件时必须指向目录写成单个文件会直接报错。第四步防覆盖、可回改操作追加--check不覆盖已有文件追加-e把图表副本嵌入导出产物。 你会看到目标文件已存在时生成带序号后缀的新文件嵌了副本的 PNG/PDF 之后还能被 draw.io 重新打开继续编辑。 选择参考和在线版、Visio 怎么选维度draw.io 桌面版在线版diagrams.netMicrosoft Visio平台Windows / macOS / Linux任意浏览器仅 Windows成本免费Apache 2.0基础免费高级功能付费付费订阅网络依赖完全离线更新检查可关必须联网文件可上云可离线VSDX导入导出支持导入支持有限原生批量导出内置 CLI不支持有限可定制性开源可 fork 构建固定固定适合谁在 macOS/Linux 上经常收到 Visio 文件的用户图表涉密、不能走云端的企业团队需要脚本化、可重复导出流水线的工程师。不适合谁依赖 Visio 专业图形库和模板生态的重度用户需要多人实时协同编辑的场景——桌面版没有在线协作。另外项目不接收外部 PR要深度二次开发请看下面收尾部分的个人构建文档。️ 踩坑记录5 个高频问题1. 启动后空白页或直接报错原因clone 时漏了--recursivedrawio/编辑器核心目录是空的。 处理在仓库根目录执行git submodule update --init再npm start。2. npm install 报 engine 相关错误原因Node 低于 22.12这是package.json里engines写死的下限。 处理把 Node 升到 22.12 以上再重装依赖。3. 内网环境启动慢或提示更新失败原因设计上启动时会连接官方发布源检查一次版本。 处理设环境变量DRAWIO_DISABLE_UPDATEtrue或启动时加--disable-update集中管控的部署建议统一关闭。4. 批量导出后只看到一个文件或直接报错原因--output指向了单个文件后面的文件会逐个覆盖前面的结果。 处理--output指向目录单文件输出只允许单个输入。5. 打开某个图表时观察到对外请求原因图表本身引用了外部资源——图片、背景或字体嵌着 URL打开时应用会按需抓取以便正常渲染。 处理只打开可信来源的图表文件README.md 的 Security 一节对这个行为有明确说明。 收尾现在就能做的三件事装好官方版本或用上面的 3 条命令跑起源码打开第一个 VSDX 并导出 PDF给自己团队的 diagrams 目录写一条批量转换命令放进 CI 或文档流水线内网环境提前用DRAWIO_DISABLE_UPDATEtrue关掉更新检查避免无谓的等待想继续深入安装与安全设计见 README.md个人无签名构建流程见 doc/BUILDING_FOR_PERSONAL_USE.md全部 CLI 参数看 src/main/args.js配套解析测试在src/test/目录。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考