ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

drawio-desktop 完整指南:批量导出图表、离线编辑 VSDX 与跨平台协作

drawio-desktop 完整指南:批量导出图表、离线编辑 VSDX 与跨平台协作 drawio-desktop 完整指南批量导出图表、离线编辑 VSDX 与跨平台协作【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktopdrawio-desktop 是 draw.io 官方团队用 Electron 打包的桌面版图表编辑器专为需要在 Windows、macOS、Linux 三端之间传递 Visio 文件、把整目录图表批量转成 PNG/PDF 的团队设计。它支持直接打开.vsdx、.mmdMermaid、.csv文件并在线编辑内置命令行导出引擎默认不联网、不采集任何使用数据。Apache 2.0 许可个人与商用均无费用。它解决了什么问题与常见替代方案的对比对比维度商业绘图套件如 Visio在线转换网站drawio-desktopVSDX 打开后可编辑仅 Windows多为只读预览或样式丢失形状、连线、图层均可改批量导出整目录需逐文件手动操作通常单次上传一条 CLI 命令递归处理离线 / 内网可用部分功能依赖云端必须联网默认完全离线CSP 禁止加载远程脚本数据是否外发视厂商策略文件上传到第三方服务器图表数据仅存本机不发送任何分析数据平台覆盖主要 Windows任意需网络Windows / macOS / Linux 本地运行许可按席位收费免费但受配额限制Apache 2.0免费商用核心差异点Visio 的 VSDX 文件离开 Windows 后往往只能看不能改在线工具则把文件传到远端处理。drawio-desktop 把解析和渲染都放在本地进程内完成改完直接存回.vsdx或导出为其他格式。快速上手安装与首次运行方式 A下载预构建安装包从项目 Releases 页面获取对应平台的二进制文件。Windows 提供三种形态NSIS 安装版-windows-installer.exe装到Program Files需要管理员权限适合个人电脑。MSI 安装版.msi装到用户目录无需管理员权限适合公司统一管控的机器。便携版-windows-no-installer.exe解压即可运行不注册文件关联适合 U 盘携带或无权限环境。macOS 提供.dmg和.zipLinux 提供.AppImage、.deb、.rpm、.snap。方式 B从源码构建适合想改壳层代码如窗口标题、导出默认参数的开发者。前提Node.js ≥ 22.12.0。git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm start--recursive不可省略——核心编辑器drawio是以 git submodule 嵌入的缺少它构建会直接失败。如果已经 clone 过补一句git submodule update --init即可。首次启动后界面分为三栏左侧是形状搜索与分类库中间是带网格的画布右侧是当前选中对象的属性面板颜色、字体、连线样式等。操作逻辑与 Visio 接近拖入形状后在右侧调整属性即可。按使用频率拆解核心功能1. 打开并编辑 VSDX 文件场景产品经理在 Windows 上用 Visio 画好架构图发给 Mac / Linux 同事对方双击文件提示无关联程序或只能看到只读预览。做法在 drawio-desktop 中通过文件 → 打开选择.vsdx或直接拖入窗口。编辑器会解析出形状、连线、分组和图层全部变成可拖拽、可改色的对象。改完后文件 → 另存为可以选择存回.vsdxWindows 同事能继续编辑或导出为.png/.pdf/.svg。收益不再需要截个图 → 群里发 → 对方用截图 PPT 里贴一下的链路改一个标注只需几秒存回后对方在 Visio 里看到的就是更新后的版本。除了.vsdx导出模式的输入同样接受.drawio、.xml、.csv、.mmd/.mermaid详见下文批量导出部分。2. 命令行批量导出整目录图表场景文档仓库里有一百张.drawio流程图需要转成 PNG 嵌进 PDF 手册逐张打开 → 导出 → 命名半天就没了。做法桌面版内置了 CLI 导出引擎参数解析逻辑见 src/main/args.js在终端里执行drawio -x -f png -r -o ./exported ./diagrams参数含义-x进入导出模式不打开 GUI-f png输出格式可选pdf、png、jpg、svg、xml、html-r递归子目录-o ./exported输出目录必须是文件夹多文件时常用扩展参数参数作用-t/--transparentPNG/SVG 透明背景-s 2/--scale 22 倍缩放适合 Retina 截图--width 800/--height 600按指定尺寸等比适配-b 20/--border 20图四周留白像素-a/--all-pagesPDF/HTML 导出时包含所有页-p 2/--page-index 2只导出第 2 页1-based-l 0,2/--layers 0,2只导出第 0、2 层-k/--check不覆盖已存在的输出文件-c/--create无输入文件时创建空文件写进 Makefile 或 CI 脚本后每次提交自动重新渲染配图几秒钟完成。3. 默认离线运行数据不出本机场景保密项目不允许图表经过任何第三方服务器或者部署在无外网的内网机房。做法drawio-desktop 的主进程在启动时通过 CSP 头见 src/main/electron.js 中onHeadersReceived拦截逻辑禁止界面加载任何远程 JavaScript网络请求被限制为应用自身。所有图表数据存储在本地文件系统不发送分析数据。如果连启动时的版本检查也要关掉有两种方式# 方式一环境变量 export DRAWIO_DISABLE_UPDATEtrue drawio # 方式二启动参数 drawio --disable-update对应的判断逻辑在 src/main/disableUpdate.js 和 src/main/electron.js 中。个人构建打包时还可通过npm run sync -- disableUpdate让版本永久跳过自动更新见 个人构建指南。适用场景与边界适合团队成员跨 Windows / macOS / Linux 传递 Visio 文件且需要打开即编辑而非只读预览。文档 / 代码仓库中维护大量图表需要 CI 批量重新渲染。内网或保密环境不允许数据经过第三方服务器。习惯用 Git 管理图表版本.drawio是 XML 文本可直接 diff。不适合 / 需要注意复杂 Visio 工程数百页、大量自定义形状模板、ActiveX 控件的 1:1 还原——draw.io 解析 VSDX 时会尽量保留结构但 Visio 私有扩展属性可能丢失。需要 Visio 独占的高级功能如 stencil 数据库、数据链接到 Excel不在支持范围内。项目对社区 PR 持封闭策略见 README 的 Not open-contribution 一节可以 fork 后自行修改构建但上游不接收功能 PR。图表中若嵌入了外部 URL 引用的图片/字体打开时仍会向该 URL 发起请求这是渲染需要不是数据上报。速查表CLI 常用命令用途命令批量导出目录为 PNGdrawio -x -f png -r -o ./out ./diagrams导出单个文件为 PDF带 30px 边距drawio -x -f pdf -b 30 file.drawio导出透明背景 SVG2 倍缩放drawio -x -f svg -t -s 2 file.drawio导出所有页为 HTMLdrawio -x -f html -a file.drawio查看版本drawio -V查看帮助drawio -h环境变量与启动参数名称说明DRAWIO_DISABLE_UPDATEtrue关闭启动时版本检查--disable-update同上命令行形式--no-silent-update下载更新前弹窗确认而非静默替换--disable-acceleration禁用硬件加速兼容旧显卡DRAWIO_ENVdev开发模式自动打开 DevToolsDRAWIO_UNSIGNEDtrue个人构建时跳过代码签名见构建文档窗口记忆桌面版自动记录窗口大小、位置和最大化/全屏状态逻辑见 src/main/window-bounds.js。多显示器拔插后如果上次位置已不可见窗口会自动回退到主屏居中避免窗口跑到不存在的屏幕上。本地数据路径平台路径macOS~/Library/Application Support/draw.ioWindowsC:\Users\用户名\AppData\Roaming\draw.io\下一步先装一个预构建包打开手里那份.vsdx确认能正常编辑再决定是否需要从源码构建。把导出命令写进团队的 CI 或 Makefile让图表随代码一起版本化。遇到个性化需求改窗口标题、定制默认导出参数、内网部署阅读 doc/BUILDING_FOR_PERSONAL_USE.md 中的 fork 构建流程设好DRAWIO_UNSIGNEDtrue即可在本地打包签名。关键文件索引参数解析与帮助文本src/main/args.js主进程与导出流程src/main/electron.js更新关闭逻辑src/main/disableUpdate.js窗口尺寸恢复src/main/window-bounds.js个人构建指南doc/BUILDING_FOR_PERSONAL_USE.md发布流程doc/RELEASE_PROCESS.md【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表