企业官网建设流程全解析

draw.io 桌面版完整指南：离线绘图到 SVG 导出的 4 步实践

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

draw.io 桌面版（drawio-desktop）是开源绘图工具 draw.io 的官方 Electron 封装，在 GPL v3 许可下让你完全离线地创建与导出流程图、UML 和架构图。图表数据只写入本机目录，不会外发。本文带你选对安装包、从源码编译、跑通从画图到 SVG 导出的完整流程，并掌握命令行批量转换，适合需要断网办公、数据留本地的开发者。

📦 安装 draw.io 桌面版前需要了解的 3 件事

它是什么，什么许可

仓库本身只是一层 Electron 桌面外壳，真正的绘图引擎放在drawio/目录下的 git 子模块里。应用采用 GPL v3 许可免费使用，不改动代码即可用于任何用途。

离线是设计目标

应用仅会在启动时联网检查新版本。所有 JS 自包含，CSP（Content Security Policy，限制脚本可加载来源的浏览器机制）禁止运行远端代码，图表内容与使用统计一律不对外发送。

数据存在哪里

本地与 Session 存储位于用户目录：macOS 为~/Library/Application Support/draw.io，Windows 为C:\Users\<用户名>\AppData\Roaming\draw.io\；你保存的图表文件同样只在本机。

🪟 上手路径：安装包与源码二选一

挑选 Windows 安装包

发布页提供三种安装包：

• draw.io-<version>-windows-installer.exe：NSIS 整机安装到 Program Files，需要管理员权限；
• draw.io-<version>.msi：按用户安装到用户目录，无需管理员；
• draw.io-<version>-windows-no-installer.exe：便携版，免安装即可运行，但不注册文件关联。

此外还有面向 Windows on Arm 的原生 ARM64 构建，以及可按用户安装、免管理员的 Microsoft Store（APPX）版本。

源码构建三步走

先装好 Node.js 22.12 及以上（官方构建使用 Node 24），再执行：

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

--recursive不能省，否则drawio子模块拉不下来、编辑器无法打开。想看详细日志就追加--enable-logging，想打开 DevTools 调试面板则设置环境变量DRAWIO_ENV=dev。

🖼 完整流程：从空白画布到 SVG 导出

1. 从左侧形状库拖入两个矩形，改名为"Web 服务"和"数据库" → 形状按网格吸附落位，两个节点都带上了文本。
2. 鼠标悬停在矩形边缘，点出的连接点拖向另一个矩形 → 两节点间建立带方向的连线，架构图主干成形。
3. 在右侧属性面板打开 Grid、步长设为 10pt，按需切换纸张尺寸与方向 → 整幅图版式统一。
4. File 菜单下保存为.drawio，再执行 SVG 导出 → 得到可进版本库的.drawio源文件和可直接放进文档的矢量 SVG。

⚡ 绘图之外：界面、更新控制与 CLI 批量导出

三栏式界面布局

左侧形状面板顶部有 Search Shapes 可快速检索；中央画布为浅灰网格，视图可无限滚动；右侧属性面板随选中对象联动，管理网格、箭头、背景与纸张设置。

关闭自动更新

设置环境变量DRAWIO_DISABLE_UPDATE=true，或在启动参数里加--disable-update，应用启动时便不再检查新版本，适合集中部署的内网环境。

命令行批量导出

打包后的程序支持命令行转换：除.drawio外，输入还支持 vsdx、csv、Mermaid（.mmd/.mermaid），用--recursive可对文件夹递归处理；输出支持 xml、html、pdf、png、jpeg、svg 六种格式（默认 pdf），--all-pages导出 PDF 全部页，--layers选图层，--quality调 JPEG 质量（默认 90），--border、--scale控制尺寸。示例：

drawio -x -f svg -r ./diagrams

🛑 排错：5 个高频问题与处理办法

1. 现象：编辑器窗口空白或启动直接失败；原因：克隆时漏了--recursive，drawio子模块缺失；处理：在仓库目录先执行git submodule update --init，再启动应用。
2. 现象：Windows NSIS 安装器提示权限不足；原因：整机安装写入 Program Files，要求管理员身份；处理：改用.msi按用户安装或便携版。
3. 现象：源码改过，启动后行为照旧；原因：应用持有单实例锁，第二次启动只会复用已有进程开新窗口；处理：先关闭所有正在运行的 draw.io，再npm start。
4. 现象：打开陌生来源的图表时出现发往外部域名的请求；原因：图内引用的外部图片、背景、字体会在打开时拉取，可能泄露你的 IP；处理：打开前先检查文件里的外部引用。
5. 现象：Linux AppImage 启动失败，报fuse: memory allocation failed；原因：31.4.2 起 AppImage 改用静态运行时，旧版 AppImageLauncher 2.x 无法加载；处理：升级到 AppImageLauncher 3.0（beta）或直接卸载它（运行 AppImage 并不依赖它）。

📚 深入阅读

官方构建经过代码签名与公证，自建包需设置DRAWIO_UNSIGNED=true跳过签名，且项目不接收上游代码贡献。延伸阅读：doc/BUILDING_FOR_PERSONAL_USE.md（自建完整流程）、DEVELOPMENT.md（发布与 CI）、README.md（许可、安全设计与存储位置）。draw.io 桌面版把绘图工具搬回本地：界面、数据、导出全程离线，再配命令行参数即可应对批量文档场景。

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