draw.io 桌面版安装指南：免费离线画图工具，3 分钟从下载到验证跑通

draw.io 桌面版安装指南：免费离线画图工具，3 分钟从下载到验证跑通

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

draw.io 桌面版是 draw.io 官方 Electron 构建，GPL v3 许可、完全免费，离线运行，画流程图、UML 和架构图不依赖网络。适合需要在内网、离线环境出图的工程师。本文给出 Windows、macOS、Linux 的完整安装步骤、首次启动验证与故障排查，照做即可一次跑通。

安装前选包：按架构和权限二选一

先确认两件事：CPU 架构（Linux 终端执行uname -m，返回x86_64为 x64、aarch64为 arm64；macOS 在「关于本机」看芯片）和是否有管理员权限。没有管理员权限时，Windows 一律选 MSI 或便携 zip，二者都按用户安装、免管理员。

安装包从官方发布页下载，文件名带版本号（当前为 32.4.1），下载完成后先核对位数再安装。

分平台安装步骤

Windows 安装步骤

1. 下载与架构匹配的包并运行安装程序，按向导点完。NSIS 版需要管理员；MSI 与便携版免管理员。成功标志：桌面或开始菜单出现 draw.io 入口。
2. 启动一次应用。成功标志：主窗口正常显示，且 .drawio / .vsdx / .mmd 文件关联已注册（便携 zip 除外）。

macOS 安装步骤

1. 下载与芯片匹配的 dmg（x64、arm64、universal 三种）。成功标志：下载完成，得到 .dmg 文件。
2. 打开镜像，把 draw.io 拖进「应用程序」文件夹。成功标志：应用程序文件夹出现 draw.io。
3. 首次打开若被 Gatekeeper 拦截，在「系统设置 → 隐私与安全性」点「仍要打开」。成功标志：主窗口出现。

Linux 安装步骤

1. AppImage 免安装路线：终端执行chmod +x <文件>.AppImage，然后直接运行该文件。成功标志：主窗口出现。
2. 或走包管理器：deb 执行sudo apt install ./<文件>.deb，rpm 执行rpm -i <文件>.rpm。成功标志：应用菜单出现 draw.io，可正常启动。

从源码构建运行

需要 Node.js 22.12 以上（官方构建用 Node 24）。核心编辑器是 git 子模块，clone 必须带--recursive：

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

成功标志：主窗口从源码启动。要打包个人构建，走 doc/BUILDING_FOR_PERSONAL_USE.md 的流程，设置DRAWIO_UNSIGNED=true跳过签名与公证。

首次启动验证：三个动作跑通最小闭环

1. 打开空白画布，确认左侧形状库、中央画布、右侧属性面板齐全。成功标志：三个区域均正常渲染，可缩放画布。
2. 核对版本号：Help → About。成功标志：显示的版本与安装包文件名一致（当前 32.4.1）。命令行传-V也可打印版本号后直接退出。
3. 拖一个矩形进画布，File → Save 存成 .drawio，退出应用后重新打开该文件。成功标志：内容还在，图形位置不变。

📌 图表和配置存在本机用户目录：Windows 在C:\Users\<用户名>\AppData\Roaming\draw.io\，macOS 在~/Library/Application Support/draw.io，备份时整目录复制。内网机器想彻底关闭自动更新，启动时加--disable-update或设环境变量DRAWIO_DISABLE_UPDATE=true；只想在下载前询问，用--no-silent-update。

draw.io 桌面版故障排查

• 双击 .drawio 不用它打开 → 便携 zip 不注册文件关联 → 换 NSIS 或 MSI 重装，或右键「打开方式」指定程序。
• AppImage 启动报fuse: memory allocation failed→ 31.4.2 起 AppImage 使用静态运行时，旧版 AppImageLauncher 2.x 无法加载 → 升级 AppImageLauncher 到 3.0 及以上，或直接卸载它，AppImage 本身不依赖它。
• 更新检查失败，版本停在旧版 → 离线机器连不到更新服务器 → 手动下载新版安装包覆盖安装，或加--disable-update启动。
• 安装时提示权限不足 → NSIS 安装程序需要写 Program Files → 换 MSI 或便携版，二者免管理员。
• 打开别人分享的图，外部图片空白 → 图内引用了外部 URL，离线拉取不到 → 让编辑端把图片转成本地嵌入再导出。

仓库内深入入口

• doc/BUILDING_FOR_PERSONAL_USE.md：从 fork 构建个人无签名包的完整流程，含同步版本号与禁用自更新。
• electron-builder-linux-mac.json：macOS 与 Linux 的打包配置，dmg、AppImage、deb、rpm 的目标架构和 .drawio / .vsdx / .mmd 文件关联都定义在这里。
• src/main/args.js：全部命令行参数定义（导出格式、--disable-update等），做命令行批量导出时查这里。
• src/main/electron.js：主进程入口，窗口管理、单实例锁与自动更新逻辑都在此。

快速答疑

桌面版收费吗？不收。GPL v3 许可，不改代码即可免费用于任何用途。

怎么确认装的版本？看 Help → About，或在命令行传-V打印版本号后退出。

支持多人实时协作吗？不支持，协作靠导出 .drawio 文件传递。

完全离线的机器能装吗？能，安装包不依赖网络，装完用--disable-update关掉更新检查即为完整离线安装。

在线版存的图能用吗？能，把 .drawio 文件拖进桌面版即可打开。

结语

装完之后的日常就是画图、保存、偶尔备份存储目录；卡住时回「draw.io 桌面版故障排查」一节，按「现象 → 原因 → 解法」逐条对照处理即可。

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