企业官网建设流程全解析

draw.io 桌面版离线绘图安装指南：3 步装好并本地验收

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

draw.io Desktop 的安装与验收指南，面向第一次装它的工程师：下载、装好、确认能用，3 步走完。它是 JGraph 官方的 Electron 桌面构建，GPL v3 许可，任何用途免费，画流程图、UML 时不联网。当前版本 32.4.1，全文覆盖选包、按系统安装、验收、排障和答疑 5 部分。

动手前先决定：按架构、权限和使用场景选包

先确认 3 件事：CPU 架构、有没有管理员权限、装来做什么。结果直接决定你下载哪个文件。

📌 MSI 只有 x64 版，ARM 机器上靠模拟运行。更新行为与安装方式绑定：.exe、dmg、AppImage 会后台下载新版本；MSI、.zip、deb、rpm只提示并链接到发布页；Microsoft Store、Snap、Flatpak 由商店自己更新。

按系统安装：Windows、macOS、Linux 各自的 3 步

Windows 上怎么装

1. 从发布页下载与架构匹配的安装程序，文件名含版本号 32.4.1 即下载完成。
2. 运行安装程序，按向导点完。完成 = 你会看到 Program Files 里出现 draw.io，且.drawio文件关联已注册。无管理员权限的机器改用.msi，同样免管理员。
3. 从开始菜单启动。完成 = draw.io 主窗口出现。

macOS 上怎么装

1. 下载与芯片匹配的 dmg：x64、arm64、universal三种都有。完成 = 下载管理器里的 dmg 文件名含 32.4.1。
2. 把 draw.io 拖进「应用程序」文件夹。完成 = 应用程序文件夹里出现 draw.io 图标。
3. 首次打开被 Gatekeeper 拦截时，到「系统设置 → 隐私与安全性」点「仍要打开」。完成 = 主窗口出现。

Linux 上怎么装

1. 拿AppImage或deb/rpm包，文件名带版本号即下载完成。
2. AppImage 免安装：加执行权限后直接运行；或用包管理器安装。

   chmod +x drawio.AppImage && ./drawio.AppImage

   或

   sudo apt install ./drawio.deb

   完成 = 命令无报错退出，或包管理器提示Setting up drawio。

3. 从应用菜单启动。完成 = 主窗口出现。

从源码构建

需要 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跳过签名。

装完怎么算成功：3 项验收一次过

3 项全部通过，才算装好；任何一项不过，回上一节核对安装方式。

1. 界面齐全：左侧形状库、中央网格画布、右侧属性面板三块都在。
2. 版本号一致：应用菜单「关于」显示 32.4.1，与安装包文件名里的版本号相同。
3. 一次最小往返：拖一个矩形进画布，File → Save 存成.drawio，完全退出再重开，矩形还在。

📌 图表和配置存在本机用户目录：Windows 在C:\Users\<用户名>\AppData\Roaming\draw.io\，macOS 在~/Library/Application Support/draw.io，备份时整目录复制。

装完出问题了：4 种常见现象对照处理

原因都落在具体机制上，对照现象找行。

一句话答疑 + 仓库深入入口

• 桌面版收费吗？不收，GPL v3 许可，不改代码即可用于任何用途。
• 如何确认装的版本？看应用菜单「关于」，或在命令行传-V，打印版本号后直接退出。
• 支持多人实时协作吗？不支持，协作靠导出.drawio文件传递。
• 完全离线的机器能装吗？能，安装包不依赖网络；启动加--disable-update后就是完整离线安装。

想动构建和行为逻辑，看这 3 个入口：

• doc/BUILDING_FOR_PERSONAL_USE.md：从 fork 构建个人无签名包的完整流程，含同步版本号和禁用自更新，个人构建时看。
• electron-builder-linux-mac.json：macOS 与 Linux 的打包配置，dmg、AppImage、deb、rpm的目标架构和文件关联都定义在这里，改打包目标时看。
• src/main/args.js：全部命令行参数的定义与解析，-V、--export、--format都在这，离线批量导出图时看。

装好后的日常就是画图、保存、偶尔备份存储目录。卡住时回「装完出问题了」一节对照处理，更新相关的问题再看开头的更新行为一行。

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