drawio-desktop 教程:本地图表编辑器,批量导出 6 种格式,Visio 文件兼容 drawio-desktop 教程本地图表编辑器批量导出 6 种格式Visio 文件兼容【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktopdrawio-desktop 是 draw.io 的官方 Electron 桌面构建让你在本地离线环境打开、编辑并批量导出 VSDX、CSV、Mermaid 等图表文件。如果你的团队 Mac 和 Linux 混用、要处理同事发来的 Visio 文件或需要随文档发布交付一批 PNG 图它可以替代逐个打开界面操作的工作。当前版本 32.4.1见 package.json 的 version 字段采用 GPL v3 许可不修改代码即可用于任何用途。跑通第一次最小上手路径前置条件Node.js 22.12 及以上package.json 的 engines 声明为 22.12.0加 npm安装依赖阶段需要联网。git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm start第 1 条命令的--recursive不能省核心编辑器 drawio 是 git submodule漏掉它 drawio/ 目录是空的应用无法启动。npm install完成后依赖落进 node_modulesnpm start启动编辑器窗口。启动后界面分三块左侧形状库、中央网格画布、右侧属性面板拖一个矩形进画布即可开始画图。排障用两个开关npm start --enable-logging打开日志输出报错信息会打印到终端DRAWIO_ENVdev npm start会自动打开浏览器 DevTools。高频任务单文件导出为 PNG/PDF/SVG场景图表画完需要一张 PNG 贴进文档或一份 PDF 归档。drawio -x -f png -o flowchart.png architecture.drawio-x启用导出-f指定格式pdf、png、jpg、svg、xml、html 共 6 种不写默认 pdf-o指定输出文件输出名带扩展名时以扩展名为准。结果命令结束flowchart.png 生成在 -o 指定的位置。Visio VSDX 文件直接转换场景同事发来 .vsdx你的机器是 Mac 或 Linux没有 Visio。drawio -x -f svg -o design.svg design.vsdxVSDX以及 CSV、Mermaid 的 .mmd/.mermaid都在支持的输入列表里直接当输入文件不需要先转成别的格式。结果生成 design.svg图表内容完整保留可再用 drawio 打开继续编辑。整目录批量导出 PNG场景docs 目录下有 20 张架构图要随发布说明一起交付 PNG。drawio -x -f png -r -o ./docs-images ./docs-r递归处理子目录只对文件夹输入生效输出文件与输入同名、扩展名换成 .png加-k则跳过已有输出文件的条目适合反复运行的增量导出。结果一条命令跑完20 张 PNG 全部落在 docs-images 目录。它能不能做什么对比项drawio-desktopMicrosoft Visio在线绘图工具平台Windowsx64/ARM64、macOS 13、Linux 官方包以 Windows 为主依赖浏览器费用免费GPL v3需购买授权免费或订阅制数据流向完全本地唯一外连是每日版本检查本地文件需上传服务器输入格式drawio、VSDX、CSV、Mermaid原生 VSDX因工具而异输出格式PDF、PNG、JPG、SVG、XML、HTML 共 6 种视版本而定因工具而异它也有两个明确的边界不接受贡献项目对社区 PR 关闭见 README.md 的 Not open-contribution 一节但 GPL v3 允许你 fork 后修改并构建个人版本流程在 doc/BUILDING_FOR_PERSONAL_USE.md。系统要求不提供 32 位 Windows 包macOS 需 13 及以上Electron 44 移除了 ia32 与 macOS 12 支持。避坑与细节常用参数完整参数定义在 src/main/args.js高频的几个-k--check不覆盖已存在的输出文件配合批量导出做增量--page-range 1..4按 1 起始的页码选页仅对 PDF 格式生效-e--embed-diagram把原图嵌入 PNG/SVG/PDF导出后还能再编辑纯展示图片不建议用文件会变大-q 90JPEG 输出质量默认 90要更小的文件就调低性能--size diagram默认把输出裁到图表内容范围比整页导出更轻需要完整页面时才用--size page--layout verticalFlow导出前跑一次布局算法预设名有 verticalFlow、horizontalFlow、verticalTree、horizontalTree、radialTree、organic复杂文件耗时更长--timeout 60单文件超过 60 秒记为失败并继续下一个默认 0 表示不限批量任务防坏文件卡死时用安全与隐私DRAWIO_DISABLE_UPDATEtrue或--disable-update关闭更新检查这是应用唯一的外连动作每天一次相关逻辑在 src/main/electron.js不要打开不可信来源的图表图表可引用外部图片、背景或字体打开时会请求这些 URL把你的 IP 暴露给对方服务器应用的 CSP 禁止远程 JavaScript图表数据与使用统计都不外传快速问答Q如何验证命令行可用A运行drawio -V能打印版本号当前 32.4.1即可drawio -h查看完整参数列表。QWindows 没有管理员权限装哪个包A选.msi按用户安装不需要管理员或便携版 zip免安装但不注册文件关联NSIS 的.exe是按机器安装需要管理员权限。Q源码方式启动不了怎么办A先确认 clone 时带了--recursive否则缺编辑器 submodule然后用npm start --enable-logging打开日志输出看终端报错需要 DevTools 就改用DRAWIO_ENVdev npm start。把 6 种格式各跑一遍感受 PDF 和 SVG 的差别再把带-k的批量导出命令写进文档发布脚本。命令行熟悉之后图表文件对你来说就不再是平台问题了。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考