企业官网建设流程全解析

drawio-desktop 上手指南：4 条命令从源码启动，命令行批量导出图表

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

drawio-desktop 是 draw.io 的官方 Electron 桌面构建。它解决两件事：跨平台打开图表文件，离线批量导出图片。当前源码版本 32.4.1，支持 Windows、macOS、Linux。

源码安装：4 条命令把 drawio-desktop 跑起来

装好 Node.js 22.12 及以上版本后，从克隆到启动只需要 4 行命令。核心编辑器是 git submodule，clone 必须带--recursive，否则 drawio 目录为空，应用无法启动。

这一步把源码拉到本地并启动应用，共 4 行命令：

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

得到可交互的编辑器窗口：左侧形状库、中央网格画布、右侧属性面板。

安装后如何验证版本，跑这两条命令：

drawio -V drawio -h

第一条打印 32.4.1 这样的版本号，第二条列出全部参数。

这个桌面版能做什么：四个核心点

值得装的点有四个。

• 官方构建：Electron 封装 draw.io 核心编辑器，Windows、macOS、Linux 都有官方安装包。
• 免费使用：GPL v3 许可，不改代码即可用于任何用途；核心编辑器 drawio 子模块保持 Apache 2.0。
• 格式覆盖广：输入支持 drawio 文件、VSDX、CSV、Mermaid，输出支持 PDF、SVG、PNG、JPG、XML、HTML。
• 数据不出本机：默认不连外网，唯一例外是更新检查，可用--disable-update关闭。

真实场景：从单文件到整个目录的导出

导出是最常用的操作，三个场景对应三类命令，全部定义在 参数解析器 中。

单文件导出：drawio 转 PNG 怎么写

交付文档需要一张架构图 PNG，手动点导出太慢。

一句命令完成单文件多格式导出：

drawio -x -f png -o flowchart.png architecture.drawio

PNG 写到-o指定的路径，输出名带扩展名时以扩展名为准。

Visio 文件转换：VSDX 如何直接打开

同事发来的 Visio 文件想在 Mac 上查看，不必再转手。

VSDX 在受支持的输入格式里，直接当输入文件：

drawio -x -f svg -o design.svg design.vsdx

得到矢量 SVG，放大不失真。

批量导出命令怎么写：整个目录递归转 PNG

docs 目录下有 20 张架构图，要随发布说明一起交付图片。

文件夹输入加-r递归子目录，输出指向一个文件夹：

drawio -x -f png -r -o ./docs-images ./docs

输出与输入同名、扩展名换成 .png。加-k可跳过已存在的文件，适合增量导出。

进阶选项与容易翻车的点

常用参数分三组记住，格式统一为“参数 — 作用 — 何时用”。

导出控制：

• -g, --page-range <from>..<to>— 按 1 起始的页码范围选页，仅限 PDF — 多页文件只导出部分时使用
• --crop— 把 PDF 裁到图表大小 — 不想留整页白边时使用
• -e, --embed-diagram— 把原图嵌入 PNG/SVG/PDF，导出后仍可编辑 — 需要二次编辑导出图时使用
• --size diagram— 默认把输出裁到图表内容范围 — 需要完整页面时才改page

性能与质量：

• --layout <name|json>— 打开后、导出前跑一次布局算法 — 复杂文件耗时更长，按需使用
• --timeout <seconds>— 超过秒数放弃该文件并继续 — 大批量导出防卡死时使用
• -q, --quality <quality>— 设置 JPEG 输出质量，默认 90 — 需要压缩体积时使用

安全与更新：

• --disable-update— 关闭自动更新检查 — 集中部署的离线环境使用
• 环境变量DRAWIO_DISABLE_UPDATE=true— 效果同参数，适合写进机器配置 — 不想每次传参数时使用
• 不可信来源的图表 — 图表可引用外部图片、背景或字体，打开时会请求这些 URL — 来源不明时先确认再打开

常见混淆

Q：如何验证命令行安装成功？A：运行drawio -V，打印版本号即成功；drawio -h列出全部参数。

Q：clone 后 drawio 目录是空的？A：必须git clone --recursive；漏了可以补git submodule update --init。

Q：Windows 没有管理员权限装哪个包？A：选 .msi 包（按用户安装，免管理员）或 zip 便携版（不注册文件关联）；NSIS 的 .exe 按机器安装，需要管理员。

Q：如何彻底关闭更新检查？A：启动时加--disable-update，或设环境变量DRAWIO_DISABLE_UPDATE=true；相关逻辑在 src/main/electron.js。

先从 6 种输出格式各导出一次，感受 PDF 与 SVG 的差别。需要改动应用行为时，参考 doc/BUILDING_FOR_PERSONAL_USE.md 构建个人版。

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