ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

drawio-desktop 3分钟快速安装:免费离线画图,Windows/macOS/Linux 全覆盖

drawio-desktop 3分钟快速安装:免费离线画图,Windows/macOS/Linux 全覆盖

drawio-desktop 3分钟快速安装:免费离线画图,Windows/macOS/Linux 全覆盖

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

drawio-desktop 是 draw.io 官方的 Electron 桌面构建,GPL v3 许可、完全免费。装完即可离线运行,画流程图、UML、架构图不依赖网络,适合需要在离线环境出图的工程师。

选哪个安装包

结论先行:没有管理员权限就选按用户安装的包(Windows 是 MSI 或便携 zip,macOS 是 dmg,Linux 是 AppImage 或 deb/rpm)。当前发布版本为 32.4.1,文件名里都带版本号,下载前先按下面这张表对号入座:

你的机器选这个文件关键点
Windows x64,有管理员draw.io-32.4.1-windows-installer.exe(NSIS)按机器装进Program Files,注册.drawio文件关联
Windows x64,无管理员draw.io-32.4.1.msi按用户装进用户目录,免管理员
Windows x64,不想安装draw.io-32.4.1-windows.zip解压后直接跑draw.io.exe;不注册文件关联
Windows ARM64draw.io-arm64-32.4.1-windows-arm64-installer.exe或...-no-installer.exe原生 ARM64 构建;MSI 只有 x64 版,在 ARM 上靠模拟运行
macOS,Apple M 芯片arm64 的.dmg文件名形如draw.io-arm64-32.4.1.dmg
macOS,Intelx64 的.dmg同上
macOS,双架构通用universal 的.dmg一份装两种芯片
Linux先跑uname -m:x86_64选 x64 包,aarch64选 arm64 包AppImage 或.deb/.rpm,文件名形如drawio-x64-32.4.1.AppImage

按安装方式装:安装包、包管理器、源码

安装包方式(Windows 与 macOS)

Windows:

  1. 从发布页下载上表对应的安装包。 校验点:下载完成,文件名里能看到版本号32.4.1。
  2. 运行安装包,按向导点完(NSIS 是安装型向导;MSI 会写入当前用户目录)。 校验点:开始菜单出现 draw.io 入口,双击任意.drawio文件默认用它打开。
  3. 启动一次。 校验点:主窗口正常显示,没有报错弹窗。

macOS:

  1. 下载与芯片匹配的.dmg并打开。 校验点:磁盘映像挂载成功,出现 draw.io 图标。
  2. 把 draw.io 拖进「应用程序」文件夹。 校验点:/Applications里出现 draw.io.app。
  3. 首次被系统拦截时,进「系统设置 → 隐私与安全性」点「仍要打开」。 校验点:主窗口出现,画布可正常显示。

Linux:AppImage 或 deb/rpm

AppImage 免安装:

  1. 给下载的文件加执行权限:
    chmod +x drawio-x64-32.4.1.AppImage

    校验点:ls -l显示文件已有x权限位。

  2. 直接运行./drawio-x64-32.4.1.AppImage。 校验点:主窗口出现,没有 fuse 报错(报错见下文排障区)。

用包管理器装:

  1. deb 系统执行sudo apt install ./drawio-x64-32.4.1.deb;rpm 系统执行rpm -i drawio-x64-32.4.1.rpm。 校验点:安装过程无依赖冲突,命令退出码为 0。
  2. 在应用菜单里启动 drawio。 校验点:应用菜单出现 draw.io,能正常打开主窗口。

源码方式跑起来

前提:Node.js 22.12 以上(官方 CI 用 Node 24),且 clone 必须带--recursive,因为核心编辑器是一个 git 子模块,漏掉会构建失败:

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

校验点:主窗口从源码启动,标题栏显示 draw.io。

注意一个坑:draw.io 每个用户只允许单实例运行。如果官方应用已在跑,源码启动的新进程只会往官方应用里开个新窗口,改代码后看不到效果——先退出所有 draw.io 再npm start。要打包个人安装包,走 doc/BUILDING_FOR_PERSONAL_USE.md,设DRAWIO_UNSIGNED=true跳过签名。

装完怎么验证能用

三步走完,就能确认这套环境可以日常出图:

  1. 看界面:空白画布打开后,左侧形状库、中央画布、右侧属性面板三块齐全,说明 web 部分加载完整。
  2. 对版本:应用菜单「关于」里显示的版本号和安装包文件名一致(32.4.1);也可以在命令行传-V参数,打印版本号后直接退出。
  3. 存一次再开:拖一个矩形进画布,File → Save 存成.drawio,退出应用,重新打开文件,矩形还在。

图和本地存储的位置记一下,备份时整目录复制:Windows 在C:\Users\<用户名>\AppData\Roaming\draw.io\,macOS 在~/Library/Application Support/draw.io。

常见报错怎么排障

双击 .drawio 文件,默认不用 draw.io 打开→ 原因:便携 zip 版不注册文件关联(NSIS/MSI 会注册) → 解法:换 NSIS 或 MSI 重装;或右键「打开方式」手动指定 draw.io 程序。

AppImage 启动报fuse: memory allocation failed,末尾跟Can't open squashfs image: Bad address→ 原因:31.4.2 起 AppImage 改用静态运行时,旧版 AppImageLauncher 2.2.0(最后稳定版)加载不了 → 解法:升级 AppImageLauncher 到 3.0 及以上,或干脆卸载它——AppImage 本身不依赖 AppImageLauncher。

更新检查一直失败,版本停在旧版→ 原因:离线机器连不到更新服务器(应用默认每天检查一次 github.com) → 解法:手动下载新版安装包覆盖安装;或启动时加--disable-update,或设环境变量DRAWIO_DISABLE_UPDATE=true,彻底关闭所有更新检查。

安装中途提示权限不足、无法继续→ 原因:NSIS 安装程序按机器安装,要写Program Files,需要管理员 → 解法:换 MSI(按用户装)或便携 zip,两者都免管理员。

别人分享的图里,外部图片位置是空白→ 原因:图内引用了外部 URL 的图片/背景/字体,离线拉取不到 → 解法:让编辑端把图片转成本地嵌入后再导出分享;桌面版本身不会把图数据发出去,只会在打开图时尝试加载图内引用的外部资源。

快问快答

桌面版收费吗?不收费。GPL v3 许可,不改代码、接受 as-is 的前提下,任何用途都能免费用。

怎么确认装的版本?应用菜单「关于」;或命令行传-V参数,打印版本号后退出。

支持多人实时协作吗?不支持。协作靠导出.drawio文件传递,对方拖进桌面版即可打开。

在线版存的图能用吗?能用。在线版导出的.drawio文件直接拖进桌面版打开,格式通用。

完全离线的机器能装吗?能。安装包本身不依赖网络,装完加--disable-update启动就是完整离线环境。

关掉静默更新但保留提示怎么做?传--no-silent-update或设DRAWIO_NO_SILENT_UPDATE=true,应用会在下载前询问,而不是静默装掉。

仓库里值得看的文件

  • doc/BUILDING_FOR_PERSONAL_USE.md:从 fork 构建个人无签名包的完整流程,含DRAWIO_UNSIGNED=true、版本同步和禁用自更新的每一步。
  • electron-builder-linux-mac.json:macOS 与 Linux 的打包目标(dmg/zip/AppImage/deb/rpm)、目标架构和.drawio/.vsdx/.mmd文件关联都定义在这一个文件里。
  • src/main/electron.js:主程序入口,单实例锁、窗口管理、更新检查都在此处;命令行参数的定义与解析在 src/main/args.js,-V、--disable-update这些开关都能在那找到出处。

日常就是画图、存.drawio、定期备份上面的存储目录;哪一步卡住了,回到「常见报错怎么排障」按现象对解法即可。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进