draw.io 桌面版 Windows 安装指南：3 种离线安装包怎么选，从零到导出第一张流程图

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

draw.io 桌面版是一个用 Electron 封装的绘图应用，把 draw.io 在线编辑器整体搬进本地，流程图、UML 图、网络拓扑都能离线画，图数据不经过任何服务器。本文解决三个具体问题：Windows 上三种安装包怎么按权限和架构选对、装完如何画出第一张图并保存导出、断网交付机器上哪些默认行为要提前处理。

⚖️ 装前决策：先定架构与权限，再选安装包

默认选 NSIS 整机型安装器draw.io-<version>-windows-installer.exe，它是官方发布的主路径；没有管理员权限的机器改选 MSI 用户型。两种安装包都不需要额外配置即可画图。

选包前核对两点，信息来自 README.md 的 Windows installation 一节：

• 架构：右键"此电脑"→ 属性，看"系统类型"。x64 选常规包；ARM64 设备选文件名带arm64的原生包。Electron 44 起已无 32 位构建（见 CLAUDE.md 的 Important Constraints）。
• 离线：应用本身全程可断网运行，但安装包要先在有网机器上下载好再拷过去。

当前仓库版本为 32.6.1（见 package.json 的version字段），发布页文件名里的<version>按实际版本号替换。

另有一个 Microsoft Store（APPX）版本，同样按用户安装、不需要管理员权限（README.md）。

最短上手路径：从启动到保存第一张 .drawio 图

1. 启动应用：NSIS/MSI 版从开始菜单点 draw.io 快捷方式；便携版直接运行解压目录里的draw.io.exe。看到窗口出现：左侧形状面板（顶部带 Search Shapes 搜索框）、中间网格画布、顶部 File/Edit/View 菜单栏，即启动成功。每个用户只有一个运行实例，重复启动只会把焦点转回已有窗口（src/main/electron.js 里用requestSingleInstanceLock实现）。
2. 放第一个形状：在左侧 General 分类里按住矩形拖到画布上松手。形状落在网格上、单击能选中，即成功。
3. 连线：再拖出第二个形状，从第一个形状的边缘按住拉线到第二个。出现带箭头的连接线，即成功。
4. 调样式：单击选中形状，在右侧样式面板改填充色、边框或字号。画布上形状随改随变，即生效。
5. 保存第一张图：顶部 File → Save，选个位置存成.drawio文件，标题栏变成你保存的文件名。随后双击这个.drawio（安装版）能直接唤起 draw.io 并还原图形，说明文件关联已生效。

⚠️ 避坑清单：断网、权限、文件关联的 5 个高频问题

1. 换机重装后本地设置全部丢失

• 现象：界面配置、最近文件等本地状态回到初始，找不回来。
• 原因：Local Storage / Session Storage 与设置都存在C:\Users\<USER-NAME>\AppData\Roaming\draw.io\（README.md 的 Local Storage 一节）。
• 处置：定期把整个目录拷到别的盘；自己画的图以.drawio文件形式存在你自选的位置，两者都纳入备份。

2. 断网机器上自动更新永远失败

• 现象：NSIS 整机型装法默认后台自动更新，断网环境下每次检查都失败，白白发起请求。
• 原因：更新检查是应用唯一的默认联网行为，每天查一次 github.com（README.md 的 Security 一节）。
• 处置：交付机设系统环境变量DRAWIO_DISABLE_UPDATE=true，或启动参数追加--disable-update，彻底关检查；想保留检查、只在下载前弹窗，改用DRAWIO_NO_SILENT_UPDATE=true/--no-silent-update。MSI 与便携版只提示并给出发布页链接，无需额外处理。

3. 双击 .drawio 无反应或被别的程序抢走

• 现象：双击.drawio没有反应，或弹出了另一个程序。
• 原因：便携版本来就不注册文件关联；安装版的关联也可能被其他工具覆盖。
• 处置：右键文件 → 打开方式 → 选 draw.io → 勾选"始终使用此应用打开"。安装版默认注册.drawio、.vsdx、.mmd/.mermaid三种关联（见 electron-builder-win.json 的fileAssociations）；便携版先启动draw.io.exe，再从应用内打开文件。

4. 无管理员权限的机器装不了整机型

• 现象：运行.exe安装器弹 UAC 提示，没有管理员权限就装不下去。
• 原因：NSIS 安装器是 per-machine 安装，写入Program Files，需要管理员权限（README.md）。
• 处置：改用draw.io-<version>.msi用户型，装进当前用户目录、不弹权限框；代价是本账号专用，且新版本只提示不自动装。

5. 打开来路不明的 .drawio 会向外部发请求

• 现象：打开某个.drawio时，应用向图里引用的外部 URL 发起网络请求，可能把本机 IP 暴露给对方服务器。
• 原因：图里用 URL 引用的图片、背景、字体在打开文件时会被拉取；内容安全策略只拦远程 JavaScript，拦不住媒体请求（README.md 的 Security 一节）。
• 处置：不打开来源不明的.drawio；生产图里不粘外链资源。

🛠️ 进阶：批量导出与自打包（个人自用可跳过）

命令行批量导出 .drawio

图多不想逐个开窗口时走命令行，参数定义见 src/main/args.js：

drawio --export --format png --output out.png flow.drawio

这条命令把单个.drawio转成 PNG；Windows 下把drawio换成可执行文件路径（exe 名draw.io.exe，安装版与便携版同名，见 README.md）。几个常用参数：--format支持 pdf、png、jpeg、svg、xml、html；--all-pages导出全部页（PDF/HTML）；输入为文件夹时加--recursive连子目录一起转；输入除.drawio外还支持.vsdx、.csv、.mmd/.mermaid；完整列表用--help查。

从源码自打包（Node 22.12+）

前提：Node.js 22.12.0 以上（package.json 的engines字段）；核心编辑器是 git 子模块，克隆必须带--recursive，否则构建直接失败（README.md 的 Developing 一节）。

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

装依赖并同步版本：

npm install npm run sync -- disableUpdate

sync把版本号写入package.json，disableUpdate参数防止自建版被官方自动更新静默换回原版（见 doc/BUILDING_FOR_PERSONAL_USE.md）。最后在 PowerShell 里构建：

$env:DRAWIO_UNSIGNED="true" npx electron-builder --config electron-builder-win.json --publish never

产物落在dist/，包含 NSIS 与 MSI。自建版未签名，首次运行 SmartScreen 会警告，选"更多信息 → 仍要运行"即可。

✅ 验收收尾：3 项自检通过后即可交付

• 画一个形状、连一条线，File → Export as → PNG：导出的 PNG 能打开且图形完整，安装与导出链路全通。
• 双击刚保存的.drawio（非便携版）：draw.io 直接唤起并还原图形，文件关联注册正常。
• 断网机器启动应用正常画图：更新检查已关闭或静默失败，无干扰弹窗。

三条全过，这套离线环境即可交付；有一条不过，回"避坑清单"对应条目逐项核——关联问题看第 3 条，断网行为看第 2 条，导出异常回"进阶"一节核对参数。更多官方口径见 README.md 与 doc/BUILDING_FOR_PERSONAL_USE.md。

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