尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

别再手动逐张导出了:drawio-desktop 离线绘图与命令行批量导出,5分钟装好就能用

别再手动逐张导出了:drawio-desktop 离线绘图与命令行批量导出,5分钟装好就能用 别再手动逐张导出了drawio-desktop 离线绘图与命令行批量导出5分钟装好就能用【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop写文档要配 40 张拓扑图逐张点导出手酸、命名乱、重做更痛苦。drawio-desktop 用一条命令就能解决它是基于 Electron 的 draw.io 官方桌面版能离线绘图还支持命令行批量把整个目录的图表导出成 PNG/PDF。文档作者、架构师、DevOps 都适用装完即用。5分钟装好并跑起来只推荐一条最快路径到官方 releases 页面下载对应系统的安装包Windows 有 NSIS 安装器、MSI 和免安装便携版三种macOS 是 dmgLinux 有 AppImage 等装完双击打开。打开一个.drawio文件随便拖几个图形File 菜单导出一次 PNG——这就是你以后要自动化复刻的动作。如果你打算从源码改需要 Node.js 22.12 以上项目package.json里的硬性要求git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm start调试时加个环境变量就能自动打开 DevToolsDRAWIO_ENVdev npm start注意--recursive不能省原因在后面的避坑节里说。命令行批量导出drawio-desktop 真正的杀手锏它能做什么把图形界面里的导出动作完全搬进终端。除了.drawio文件输入还支持 Visiovsdx、CSV 和 Mermaid 文件输出支持 pdf、png、jpg、svg、xml、html 六种格式可以喂单个文件也可以喂整个目录。怎么用# 单文件导出为 PNG drawio --export -f png input.drawio # 批量递归转换目录下所有文件为 PDF drawio --export -f pdf -r ./diagrams/ # 指定输出目录不覆盖已有文件 drawio --export -f svg -o ./out/ -k ./diagrams/常用参数速查完整的可以运行drawio --help查看-f指定格式默认 pdf-o输出文件/目录-k不覆盖已存在的文件-tPNG/SVG 透明背景-qJPEG 质量1-100默认 90-s缩放比例--width按指定宽度缩放并保持比例-p选第几页从 1 开始-g 1..3页范围仅 PDF-a导出全部页-e把图表数据嵌入 PNG/SVG/PDF导出图还能反向打开编辑--theme dark|light|auto控制导出图的主题注意什么这些参数的解析逻辑是手写的就在 src/main/args.js。某个参数行为和预期不符或者你想确认自己版本支持哪些选项直接看这个文件比翻外部文档快。另外 Windows 下命令名可能叫drawio.exe需要的话用安装目录下的完整路径调用。完全离线你的图不会上网它能做什么这是 drawio-desktop 相对网页版的核心卖点。内容安全策略CSP禁止远程加载任何 JavaScript图表数据从不外传也没有任何使用统计上报。对画着内部系统架构、客户数据的人来说这点比任何花哨功能都值钱。怎么用默认就是隔离模式零配置。如果是集中管控的企业环境想把启动时的版本检查也关掉设环境变量DRAWIO_DISABLE_UPDATEtrue或启动时加--disable-update即可。注意什么一个容易忽略的边界——如果你的图表里引用了外部 URL图片、背景、字体打开文件时仍会向那些地址发起请求以正确渲染这可能把你的 IP 暴露给对方但图表内容本身不会发出去。打开来路不明的文件前留个心眼。改一行代码就是你的自定义构建它能做什么项目是 Apache 2.0 许可官方明确接受你 fork 后改代码、给自己打包一个私有版。比如给所有窗口标题加个后缀一眼就能认出自己在跑修改版。怎么用核心就三件事——克隆recursive、打补丁、用DRAWIO_UNSIGNEDtrue跳过签名和公证后调用 electron-builder 打包加--publish never避免误发布。具体命令、各平台差异macOS 的 Gatekeeper 隔离标记、Windows 的 SmartScreen 提示都写在 doc/BUILDING_FOR_PERSONAL_USE.md 里跟着走就行这里不重复贴。注意什么改的是 Electron 外壳src/main/要改绘图编辑器本身得动drawio/子模块里的 Web 代码门槛高一截。实用技巧与避坑clone 后窗口是空壳、编辑器不加载现象npm start能起窗口但画布空白。原因核心编辑器是一个 git 子模块普通 clone 拿到的只是一个空目录。解法用git clone --recursive已经 clone 过的补一句git submodule update --init。自研版和官方版一起跑改动不生效现象改了代码跑npm start界面却没有变化。原因draw.io 每个用户只允许一个运行实例自研版启动时检测到官方版还在跑就直接在官方版里开了个新窗口你的修改被吞了。解法先彻底退出官方版再启动自研版。Windows 上构建报 Trusted Signing dlib 相关错误现象打包直接失败报错指向签名凭据。原因没设DRAWIO_UNSIGNEDtrueelectron-builder 走默认签名流程且这个变量只活在当前终端会话里开新终端就丢了。解法PowerShell 里先执行$env:DRAWIO_UNSIGNEDtrue再构建。npm run release-win本地跑不起来现象本地执行发布脚本要么报错要么行为诡异。原因这些脚本是给 CI 用的构建完会尝试发布到 release 页面。解法本地打包直接调 electron-builder例如npx electron-builder --config electron-builder-win.json --publish never产物在dist/。自研版用着用着变回官方版现象装好的自定义版过几天行为回到官方默认。原因自动更新机制把它升级回了官方发布版你的修改被覆盖。解法打包前执行npm run sync -- disableUpdate生成关闭更新的配置对应 src/main/disableUpdate.js。drawio-desktop 的价值浓缩成一句就是把画和批量出图都搬到本地离线完成还能被脚本驱动。日常用它画图重活交给命令行。想进一步理解它的安全模型和构建细节doc/BUILDING_FOR_PERSONAL_USE.md 和根目录下的 README.md 是最靠谱的起点。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表