draw.io 桌面版完整安装指南：免费绘图工具覆盖流程图、UML 与架构图

draw.io 桌面版完整安装指南：免费绘图工具覆盖流程图、UML 与架构图

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

diagrams.net（draw.io）桌面版是一款免费、开源、可完全离线使用的绘图工具，支持 Windows、macOS 与 Linux 三平台，常用于绘制流程图、UML 图和架构图。本文覆盖从安装包选型、各平台安装、功能验证到后期问题处理的全过程，并说明可选的源码构建方式。

下载安装包前的检查：架构与磁盘空间

先确认 CPU 架构，架构不匹配的安装包无法安装或无法运行。

• Windows：在「设置→系统→关于」中查看「系统类型」，区分 64 位与 ARM。
• macOS：苹果菜单打开「关于本机」查看芯片型号，Intel 芯片对应 x64 包，M 系列芯片对应 ARM64 包。
• Linux：在终端执行uname -m，输出x86_64表示 64 位，aarch64表示 ARM。

另需在目标磁盘为安装目录预留约 500 MB 的可用空间。

各平台的安装包形态不同。Windows 提供三种选择：

• 便携版 no-installer.exe：无需管理员权限，适合 U 盘携带或临时试用，但不注册 .drawio 文件关联。
• NSIS 安装程序（.exe）：需要管理员权限，按机器安装，是个人日常使用的主流选择。
• MSI 包（.msi）：安装到当前用户目录，无需管理员权限，适合公司电脑与批量部署场景。

macOS 提供 dmg 格式，Linux 提供 AppImage、deb、rpm 三种格式。

drawio Windows 安装：包形态选择与文件关联

个人日常使用选 NSIS，U 盘携带或临时试用选便携版，无管理员权限的场景选 MSI。

运行所选安装程序、跟随向导完成安装；NSIS 与 MSI 版本在安装过程中会注册 .drawio 文件关联，之后双击图表文件会直接由 draw.io 打开。便携版无需安装，放到任意目录运行即可，但因未注册文件关联，.drawio 文件需要手动打开。

该平台上高频出现的两种情况：

• 安装时提示权限不足：NSIS 按机器安装，需要管理员权限。换用 MSI 或便携版，两者都不要求管理员权限。
• 双击 .drawio 无响应：通常因使用了便携版，未注册文件关联。重装 NSIS 或 MSI 版本，或右键文件通过「打开方式」手动指定程序。

drawio macOS 安装：dmg 部署与首启拦截处理

下载与芯片匹配的 dmg（Intel 为 x64、M 系列为 ARM64），挂载后将应用图标拖入「应用程序」文件夹，安装即完成。

首次启动时系统可能拦截该应用，此时前往「系统设置→隐私与安全性」点击「仍要打开」，后续启动不再拦截。

drawio Linux 安装：AppImage 与 deb、rpm 包管理器

• AppImage：为文件授予执行权限后直接运行，无需额外配置。
• deb：通过sudo apt install ./xxx.deb装入系统。
• rpm：通过rpm -i安装。

安装验证：界面布局、版本号与文件持久化

安装完成后，依次核对界面、版本号与持久化三项。

主界面布局为左侧形状库、中间画布、右侧属性面板。

打开菜单中的「关于」入口，显示版本号与安装包一致，说明安装完整。再向画布拖入一个矩形，双击输入文字，另存为 .drawio 文件；退出后重新打开，内容未丢失即表明本地持久化正常。

可选方案：从源码构建 drawio 安装包

官方发布包可覆盖绝大多数场景，仅在需要自定义构建时才从源码构建。构建环境要求 Node.js 22.12 及以上版本，流程分三步：

git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop && npm install npm run release-win

Windows ARM 目标改用release-win-arm64，Linux 目标改用release-linux。构建完成后产物位于dist/目录，构建行为由 electron-builder-win.json 等 electron-builder 系列 json 配置控制，完整构建说明见个人构建文档。

常见故障处理：性能、更新状态与运行行为

• 大图拖动、缩放卡顿：由单页元素过多导致，将密集元素拆分到多个 Page，或用图层分组管理。
• 内网机器显示「无新版本」但行为异常：离线环境更新检查走不完，状态停留在旧版。手动下载新安装包覆盖安装。
• 再次启动只在已有窗口打开新文件：同一用户仅允许一个运行实例，需先完全退出正在运行的 draw.io 再启动。
• 打开他人图表出现空白图片位：图内引用了外部 URL 资源，离线无法加载。让作者把图片转成本地嵌入后再导出。

更多问题：内网可用性、数据存放与授权

• 内网机器：可用。安装部署过程不依赖网络。若需彻底关闭更新检查，启动时加--disable-update参数，或设置环境变量DRAWIO_DISABLE_UPDATE=true。
• 在线版图表：在线版导出的 .drawio 文件可直接拖入桌面版窗口打开编辑。
• 数据存放：图表数据统一保存在本机用户目录，备份时整目录复制一份即可。
  • Windows：C:\Users\<用户名>\AppData\Roaming\draw.io\
  • macOS：~/Library/Application Support/draw.io
  • Linux：~/.config/draw.io/
• 收费情况：免费，采用开源许可，任何用途均不产生费用。

⚠️ 安全提示：来路不明的 .drawio 文件应谨慎打开。若图内引用了远程的图片、背景或字体，打开文件时会向对应服务器请求这些资源，本机的 IP 等元数据会随之暴露给对方。

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