drawio-desktop 安装教程：5 分钟跑起来，顺手把批量导出接进流水线-育师

drawio-desktop 安装教程：5 分钟跑起来，顺手把批量导出接进流水线

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

评审方要架构图每一页的 PNG，文档目录里躺着的却是三十多个 .drawio 文件。逐张开浏览器导出不可行，图里又涉及内部细节，上传在线工具更不可能。drawio-desktop 是 draw.io 的桌面客户端，基于 Electron 构建，核心能力恰好对应这两个诉求：离线运行完整编辑器，以及用命令行批量导出本地文件。下面分三条线走：装好它、从源码跑它、把它接进流水线。

📦 30 秒快速上手：安装 drawio-desktop 并导出第一张图

这一节面向只想直接用的人：从 Releases 页下载预编译包，装完第一条导出命令 30 秒内能出结果。

Windows 该挑哪个安装包

Windows 平台同时发布三种包，权限要求不同，详见 README 的 Windows installation 部分：

安装包	安装方式	是否需要管理员权限
`-windows-installer.exe`	NSIS 安装器，按机器安装到 Program Files	需要
`.msi`	按用户安装到用户目录	不需要
`-windows-no-installer.exe`	便携版，免安装	不需要

没有管理员权限的机器选 MSI 或便携版。macOS 下载.dmg拖进 Applications；Linux 用 AppImage 或 deb/rpm，Snap 系统也可以sudo snap install drawio。

装完后drawio命令即可使用（Linux AppImage 则用./drawio.AppImage）。敲出第一条导出命令：

drawio -x -f png architecture.drawio

这条命令把architecture.drawio按 PNG 格式导出，输出文件名沿用源文件名、放在源文件同目录。成功时你会在同目录看到architecture.png，终端没有报错输出。

内网集中部署还有一个值得知道的默认行为：应用只在启动时联网检查更新，其余时间完全离线，图形数据不出本机。要彻底关掉检查，设置环境变量DRAWIO_DISABLE_UPDATE=true或启动时带--disable-update即可。

🧑‍💻 开发者模式：从源码跑起 drawio-desktop

这一节面向想读代码、改行为或做个人版打包的人。编辑器核心在drawio子模块里，克隆必须带--recursive；Node 版本要求 >= 22.12.0，见 package.json：

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

克隆完成后目录里会有一个drawio/，那就是编辑器核心，缺了它构建必挂。随后执行：

npm start

应用直接从源码树启动，不需要任何安装步骤。调试时想开 DevTools，先设置环境变量DRAWIO_ENV=dev；想看更啰嗦的主进程日志，改用npm start --enable-logging。

有一个容易踩的坑：每个用户只能跑一个 draw.io 实例。如果已安装的版本还在运行，新的npm start只是往官方进程里开一个新窗口，你的改动不会生效——先退出已安装版本。个人版（无签名）打包的完整流程在 doc/BUILDING_FOR_PERSONAL_USE.md 里有分平台说明。

🔁 进阶玩法：批量导出与脚本集成

这一章按「场景 → 命令 → 预期结果」组织高频命令，不做参数逐项罗列。

整个目录的图一次出 PDF

drawio -x -f pdf -r -o ./out ./diagrams

-r递归子目录，-o指定输出目录，产出文件与源文件同名，落在./out下。再加-k则跳过已存在的文件，CI 任务重跑时不会互相覆盖。

只要某几页

drawio -x -f pdf -p 2 architecture.drawio

-p选单页（从 1 计数）；范围用-g 1..3（仅 PDF 格式支持）；-a则导出全部页面。

透明底 PNG，贴进演示文稿

drawio -x -f png -t -b 8 --width 1200 architecture.drawio

-t透明背景，-b 8留白宽度，--width 1200固定宽度且保持比例。产出的 PNG 不带底色，放进任何幻灯片模板都不突兀。

还有两处细节：输入不限于.drawio，-x同样接受 vsdx、csv 和 mermaid 文件，说明见 src/main/args.js；导出前可以先跑一遍自动布局，比如--layout horizontalFlow把流程图统一成横向走向。

🔧 排错速查

现象	可能原因	处理
Windows 启动被 SmartScreen 拦截	自编译包未签名	「更多信息 → 仍要运行」；官方签名包无此提示
源码运行看不到自己的改动	已安装版本仍在运行，新窗口归了官方进程	退出已安装版本，再`npm start`
导出没生成预期文件	参数拼写或路径有误	用`drawio -h`对照选项；确认输入路径可达
内网安装总被更新回官方版本	自动更新默认开启	设`DRAWIO_DISABLE_UPDATE=true`或加`--disable-update`
macOS 拷贝过去的包提示「已损坏」	无签名包带隔离属性	`xattr -cr /Applications/draw.io.app`
想重置设置、清空本地数据	数据存在系统应用数据目录	macOS 为`~/Library/Application Support/draw.io`，Windows 为`%AppData%\draw.io\`