企业官网建设流程全解析

draw.io 桌面版如何快速上手：3 种安装方式与离线绘图完全指南

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

画的图涉及公司机密、不能上传到云端，或者绘图电脑压根没有联网条件——这类场景下 draw.io 桌面版值得考虑。它是一个用 Electron（把网页应用打包成桌面程序的技术）构建的本地应用，默认离线工作，图表数据不会发到任何服务器。本文按"适合谁 → 怎么装 → 怎么定制"的顺序，把坑都提前说清楚。

适合谁用：先确认匹配度

• 适合：处理敏感数据的图表、无网络环境下的 draw.io 离线绘图、需要批量转换大量文件（支持命令行）。
• 不适合：只是偶尔画两张图、随手开个浏览器就够的情况；想给项目提交代码修改的情况——该项目不接受外部贡献，fork 改造仅允许自己用。

如果你的团队画的基本是非敏感图表且能联网，在线版更轻量；桌面版的价值主要在数据落地本地和断网可用。

三种 draw.io 安装方式怎么选 📦

Windows 发布目录给出三个文件，另有一个商店版，draw.io 企业部署时一般首选 MSI：

装好后双击任意 .drawio 文件即可打开编辑器。界面分三部分：左侧形状库（拖拽图形上画布）、中间网格画布、右侧属性面板（调字体、颜色、纸张大小等）。

数据有多安全：四个快速问答 🔌

数据存在哪？图表文件保存在你自己选择的位置；应用自身的本地数据（会话、缓存）在 Windows 的C:\Users\<用户名>\AppData\Roaming\draw.io\、macOS 的~/Library/Application Support/draw.io，Linux 在用户主目录对应位置。

会不会联网？默认只有一个连接：启动时检查新版本。应用不向外发送图表内容，也没有使用统计；全部 JS 代码随应用内置，内容安全策略（CSP，浏览器禁止加载执行外部脚本的机制）会拦截远程脚本。

想彻底断网？设环境变量DRAWIO_DISABLE_UPDATE=true，或启动时加--disable-update，二选一。

插件可信吗？默认关闭，启动加--enable-plugins才启用；加载外部插件需要明确确认，且运行在受限沙箱里，不能访问本地文件。

⚠️ 一个例外要知道：图里若嵌了图片、字体等外部 URL 引用，打开时会请求这些地址以便正确显示。所以别随意打开来源不可信的图。

按自己的方式定制：源码构建、批量导出、形状库 🔨

从源码构建

需要 Node.js 22.12+ 和 npm。编辑器本体是 git 子模块（一个仓库引用另一份代码的机制），克隆时必须带--recursive，否则构建会失败：

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

个人构建用不了官方签名，要设环境变量DRAWIO_UNSIGNED=true跳过签名，并预期 SmartScreen（Windows 对未知应用信誉的检查）或 macOS Gatekeeper 弹出警告，点"仍要运行"即可。个人构建默认禁用自动更新，不会被官方版覆盖，版本号可能略落后于正式发布。细节见仓库内的 doc/BUILDING_FOR_PERSONAL_USE.md。

命令行批量导出图表

桌面版本身是个命令行工具（CLI，通过敲命令操作而非鼠标点击的程序）。参数定义可查 src/main/args.js。输入支持 .drawio、.vsdx、.csv、.mmd/.mermaid；给一个目录并加--recursive会连子目录一起转；输出格式有 pdf、png、jpg、svg、xml、html。

# 批量把目录下所有图导出为 PDF（每个输入对应一个输出文件） draw.io.exe --export --recursive --format pdf --all-pages --output ./exported/ ./diagrams/ # 生成透明背景 PNG draw.io.exe --export --format png --transparent ./diagrams/arch.drawio

常用参数：--border调边框宽度，--scale缩放，--width/--height限制输出尺寸，--embed-diagram把可编辑的图数据嵌进 PNG/SVG/PDF，--all-pages一次导出全部页（仅 PDF/HTML 有效）。

自定义形状库

在 Windows 的C:\Users\<用户名>\AppData\Roaming\draw.io\shapes目录放自定义形状，用标准 SVG 定义，再通过界面导入即可，部门共用一套标准形状包时很方便。

常见坑与快速解决

自己构建的版本一启动，官方应用却弹出了新窗口？draw.io 同一用户只允许运行一个实例。官方版还在运行时，再启动你的构建只是往官方进程里开了个窗口——不带你的改动。先把所有 draw.io 全关掉。

装自构建版时 Windows 提示"已保护你的电脑"，正常吗？正常。个人构建是未签名的，SmartScreen 必然警告，点"更多信息"→"仍要运行"。

双击 .drawio 文件，没有打开我装的 draw.io？便携版不注册文件类型关联，只能右键"打开方式"手动选；换回 NSIS 安装器重装（或选"修复"），关联一般就恢复了。

加了 --enable-plugins，插件还是不加载？先确认插件文件路径是否正确，再确认参数真的传给了应用——双击快捷方式启动的场景里，参数要写在快捷方式的目标里。

该选哪种方式？

个人用选 NSIS 安装器；公司机器没有管理员权限或需要统一分发选 MSI；临时试用选便携版。完全断网环境装完加一个--disable-update，之后长期无网可用。批量转换需求直接把--export命令包进脚本，不必走界面。只有确实要改应用本身时才从源码构建，并接受未签名警告与版本略滞后。最后提醒：桌面版对贡献是关闭的，fork 改的东西只给自己用，不要当成官方版本分发。

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