企业官网建设流程全解析

drawio-desktop 快速上手指南：免费离线流程图工具 5 分钟入门

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

同事发来一份 Visio 流程图，而你的内网机器登不上在线版；架构图里还有不想上传给外网的服务拓扑。这类场景，一个离线跑的本地绘图工具就刚需了。drawio-desktop 正是为此准备的：它是 draw.io 核心编辑器的官方 Electron 桌面构建，Windows / macOS / Linux 全平台，Apache 2.0 免费开源，图完全画在本机。

认识 drawio-desktop：定位、离线设计与开源协议

它和在线版是什么关系

一句话讲：同一个编辑器，换个壳。src/main/electron.js 这类 Electron 主进程代码只负责窗口、文件对话框和命令行入口，真正的编辑器本体以 git 子模块放在 drawio/ 目录里。所以你在桌面版里看到的形状库、连线、样式能力，和网页版是同一套，差别在于文件存在本地、大图表加载更稳、还能走命令行批量干活。

为什么敢让它碰敏感拓扑

官方把"与互联网隔离"写进了第一设计目标：全部 JavaScript 自包含，Content Security Policy 禁止运行远程脚本，不采集使用统计，图表数据从不外发。唯一的默认联网行为是启动时检查新版本，而它可以被彻底关掉。拿它画保密流程或内部网络拓扑，数据全程不出本机。

免费与协议

结论是：个人和商业使用都免费，Apache 2.0 许可。README 写得很直白——不改代码并接受 "as-is" 条款，任何用途都行。想改代码自用也可以：fork 后设置DRAWIO_UNSIGNED=true构建未签名个人版本，流程在 doc/BUILDING_FOR_PERSONAL_USE.md 里有完整说明。

5 分钟装好 drawio-desktop

Windows 三种安装形态怎么选

没管理员权限就选 MSI 或便携版；公司统一分发推荐 MSI。

从源码构建的三条命令

想自己跑起来，需要Node.js22.12 及以上，然后：

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

注意：--recursive不能省——核心编辑器是 git 子模块，漏掉它drawio/会是空的，构建直接失败。

启动后是三栏布局：左侧形状库、中间画布、右侧属性面板。新建设备一张空白图，从左侧拖入矩形和菱形，用连接工具在锚点之间拉线，双击形状输入文字，右侧改填充色和线宽，最后 Ctrl+S 存成本地文件，或直接导出 PDF / PNG / SVG。启动后画布打不开或行为怪异时，用npm start --enable-logging重启一次，日志会直接告诉你原因。

drawio-desktop 能替你解决哪些活

把 Visio 老文件批量救回来

VSDX 能直接打开，而且打开后可继续编辑，不是只读预览；CSV 和 Mermaid 文本同样能当图来源打开。常见用法：把文档里积压多年的 Visio 老图打开后导出 PDF 嵌进 Wiki，不用专门开一台装 Visio 的 Windows 机器。

一条命令导出整个文件夹

图从一张变成几十张时，该上命令行模式了：

npm start -- -x -r -f pdf -o ./out ./diagrams

含义：把./diagrams里的图递归转换（-r），以 PDF 格式（-f）输出到./out，drawio、VSDX、CSV、Mermaid 都能吃，也支持指定页码范围。完整参数集定义在 src/main/args.js，读完这一个文件就掌握了 CLI 的全部能力。

导出前自动把杂乱图理直

--layout参数能对图表跑自动布局算法，预设包括垂直流、水平树、径向树、有机布局等，杂乱的图在导出前就被理顺，不用手动拖半天。

drawio-desktop 的边界与三个高频问题

适用与不适用

它适合"离线、大图表、批量转换"这类需求；不适合期待社区贡献代码的场景——项目对外部代码贡献关闭，理由是编辑器复杂度太高，维护者只欢迎 bug 报告和功能建议。

图表数据和缓存在哪里

全部落在用户应用数据目录，清缓存、做备份都去这三处：

• macOS：~/Library/Application Support/draw.io
• Windows：C:\Users\<用户名>\AppData\Roaming\draw.io
• Linux：~/.config/draw.io

完全断网的内网能用吗

结论是：能。设置环境变量DRAWIO_DISABLE_UPDATE=true，或启动时传--disable-update，启动时的版本检查就彻底消失。有个隐蔽的坑：如果图表本身内嵌了外部图片或字体的 URL，打开时会去请求那个地址以便正常渲染——它只暴露你的访问行为，不会传出图表内容，但陌生来源的图表要小心打开。

提示：批量导出前先退出已安装的官方 draw.io——同一用户只允许一个运行实例，官方版本开着时从命令行启动的副本只会往官方应用里开一个新窗口，改动不生效。

把要点浓缩成四句：免费（Apache 2.0，商用无费用）、离线（无遥测、图表不出本机）、跨平台（Win / macOS / Linux，还有免管理员形态）、兼容（VSDX / CSV / Mermaid 进，PDF / SVG / PNG / XML / HTML 出）。别只收藏了——现在就去 releases 页面下载预构建安装包，或者直接把仓库克隆下来画出第一张流程图；用得不顺手，去仓库提一个 issue。

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