drawio-desktop 桌面版图解一次安装搞定 VSDX 打开、编辑与命令行批量导出【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop周五下午同事从 Windows 机器上发来一个.vsdx文件说帮忙把流程图里的逻辑改一下。你用的是 macOS 或 Linux双击文件后系统提示没有可打开此文件的应用。这正是 drawio-desktop 想解决的日常它是 draw.io 官方出品的 Electron 桌面应用把 Web 版编辑器完整装进本地能直接打开并编辑 Visio 的 VSDX 文件还附带一个被很多人忽略的命令行导出引擎。项目速览一句话定位drawio-desktop 是 draw.io 的官方桌面封装基于 Electron 构建核心编辑器以 git 子模块形式内置Apache 2.0 许可下可免费用于任何目的。核心亮点先给你一张认知地图原生 VSDX 支持直接打开、编辑、再另存为 Visio 格式文件里图层、样式、连接关系保留完整三平台一致体验同一套界面跑在 Windows、macOS、Linux还提供 Windows 的 MSI、NSIS 安装包和免安装便携版三种形态默认离线的安全设计界面部分禁止加载远程 JavaScript图表数据不对外发送内网环境可彻底关闭自动更新命令行批量导出除 GUI 外可用--export参数把 drawio、vsdx、csv、Mermaid 文件批量转成 PDF、PNG、SVG、HTML轻量依赖与可自构建Node.js 22.12 以上即可npm start跑开发版也支持 fork 后打自己签名的个人构建。上手指南从下载到画出第一张图结论先行对绝大多数人去发布页下载对应平台的安装包即可全程不需要碰命令行想尝鲜或二次开发再走源码路线。Windows 用户有三选一安装包特点适用场景windows-installer.exeNSIS 安装器装到 Program Files需要管理员权限个人电脑常规安装.msi装到用户目录不需要管理员权限公司电脑无 admin 权限时windows-no-installer.exe免安装便携版不注册文件关联U 盘携带、临时机器macOS 用户下载 dmg 拖入 ApplicationsLinux 用户可选 deb、rpm、AppImage 或 snapsnap 版本在沙箱中运行会自动禁用自动更新。源码运行适合想改代码或验证最新功能的人git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm start注意两点--recursive必须带上因为drawio/目录是 git 子模块少了它构建直接失败另外 draw.io 单用户只允许一个实例若官方版正在运行你启动的本地版只会给官方版开新窗口。打开应用后从左侧形状库拖一个矩形到画布双击输入文字右侧面板改填充色和线宽一张流程图就成型了。保存时默认存为.drawio也可以另存为 VSDX、PDF、PNG、SVG 等。功能拆解四个值得你花时间的地方1. VSDX 文件处理从打不开到直接改解决什么问题Visio 文件在非 Windows 平台长期是孤岛在线转换工具又常常丢图层。怎么用File → Open 选择.vsdx文件即可编辑完成后 File → Save As 选 VSDX 格式写回。跨平台协作时同事之间传同一个文件不必再互相发 PDF 截图。如果你收到的 VSDX 里嵌了外部图片或字体首次打开时应用会按需请求这些 URL 以保证渲染正确——这是官方在安全说明里明确提示过的行为下文避坑部分会再提。2. 多格式导出一份图稿处处可用解决什么问题汇报用 PDF、网页用 SVG、文档插图用 PNG逐一手动导出太慢。怎么用File → Export as 弹窗里可同时勾选多种格式一次导出导出 PNG 时可选透明背景导出 PDF 时支持按页范围输出。若你的图表跨多页记得在导出前确认 All pages 选项。3. 内网安全隔离默认不联网的绘图工具解决什么问题企业内网对图能存哪、数据发不发出去有硬性要求。关键入口在src/main/disableUpdate.js与src/main/electron.js通过DRAWIO_DISABLE_UPDATEtrue环境变量或启动参数--disable-update可关闭启动时的版本检查这是官方为集中管控的安装场景专门留的口子。界面部分的 Content Security Policy 禁止运行远程加载的 JavaScript应用自身的网络连接也被限制在本机图表数据不会外传也没有使用量分析。4. 窗口状态记忆拔掉显示器也不丢位置解决什么问题外接显示器拔掉后应用窗口凭空消失是 Electron 应用的常见毛病。src/main/window-bounds.js记录了上次窗口的位置和尺寸重启时会校验这些坐标是否仍落在当前某个显示器的工作区内如果标题栏已经跑出屏幕就自动把窗口居中并缩放到主屏合适大小。源码层面这是纯函数实现配合src/test/window-bounds.test.js做了单元测试属于看不见但很贴心的一类细节。进阶玩法用命令行把导出变成自动化流水线如果你觉得每次打开软件再点导出还是慢drawio-desktop 的命令行参数值得专门学一下。它在src/main/args.js里集中定义核心能力是--exportdrawio --export --format svg --output ./out/ 架构图.drawio drawio --export --format png --scale 2 流程图.vsdx drawio --export --format pdf --all-pages 项目文档.drawio几个高频参数帮你省去翻文档的时间-f, --format支持 pdf、png、jpg、svg、xml、html不写则默认 pdf-o, --output指定输出文件或目录-s, --scale与-w, --width控制输出尺寸适合批量生成不同分辨率的插图-t, --transparentPNG/SVG 透明背景-e, --embed-diagramPNG/SVG/PDF 里内嵌一份图源方便别人改-g, --page-rangePDF 按页范围导出1-based如2..4-l, --layers按图层索引选择要导出的内容。更妙的是输入不止 drawio 格式vsdx、csv、Mermaid.mmd/.mermaid都能作为导出输入配合-r, --recursive可以把整个文件夹的图表递归转换。这意味着你可以写一个脚本每天定时把团队仓库里的 Mermaid 文件渲染成图片推到文档站真正把图表纳入 CI 流程。想自定义布局再导出--layout参数支持 verticalFlow、horizontalFlow、radialTree、organic 等预设也可以传自定义 JSON在打开后、导出前自动执行布局。常见问题与避坑清单Q装了之后弹窗提示来自不明开发者/Windows 保护了你的电脑A官方安装包是有签名的Windows 用 Azure Trusted SigningmacOS 用 Developer ID 公证。只有你 fork 之后自己构建的未签名版本才会触发系统拦截这是预期行为不是病毒。个人构建版在 macOS 上可能需要xattr -cr清除隔离属性。Q能不能给项目提 PRA项目对代码贡献是关闭的除非维护者主动允许概率极低。官方理由很直白编辑器复杂度高简单改动可能波及大量联动逻辑。想改功能走 fork 个人构建路线即可但别把你的修改版当作官方版分发。Q打开不可信来源的图会泄露什么A图里若引用了外部媒体URL 图片、背景、字体打开时会向该 URL 发起请求对方能看到你的 IP 等元数据但不会收到图表内容。官方默认策略是凡涉及默认开启外部连接的请求一律拒绝。Qnpm start后界面和官方版不一样A检查是否官方版已在前台运行或确认drawio/子模块是否成功拉取。另外开发调试建议DRAWIO_ENVdev npm start或加--enable-logging看日志。Q改了代码怎么打包成安装包A按doc/BUILDING_FOR_PERSONAL_USE.md的流程先npm run sync -- disableUpdate同步版本并禁用自动更新否则应用会自我修复回官方版再设DRAWIO_UNSIGNEDtrue调用 electron-builder 按平台打包输出在dist/。Windows、macOS、Linux 的具体命令文档里都有现成示例。收尾图表协作的最后一公里drawio-desktop 的价值不复杂它让 VSDX 文件在任意操作系统上都能被编辑让导出从打开软件点五下变成一行命令同时把数据安全边界画得清清楚楚。如果你手头正躺着一个打不开的 Visio 文件或者想给团队搭一条画图→导出→发布的自动化链路现在就可以动手。下一步克隆仓库git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop跑起开发版或直接下载对应平台的安装包体验进阶用户建议先读一遍src/main/args.js的命令行参数表那是整个自动化能力的地图。安装、安全配置、个人构建三条路线分别对应README.md、src/main/electron.js和doc/BUILDING_FOR_PERSONAL_USE.md按需取用即可。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考