draw.io 桌面版上手指南安装、命令行导出与常见坑【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktopdraw.io 桌面版drawio-desktop是基于 Electron 封装的官方桌面绘图工具把 draw.io 网页编辑器装进了本地应用支持离线打开和编辑 .drawio、.vsdx、Mermaid 等文件也能通过命令行批量导出 PDF、PNG、SVG。读完这篇你会知道该选哪个安装包、怎么从源码跑起来以及它的安全边界在哪里。桌面版是什么适合谁用它和浏览器版的功能基本一致但有两个关键区别所有数据留在本机不需要登录账号就能保存文件应用默认与互联网隔离只有更新检查会联网。Apache 2.0 协议免费商用。典型使用场景内网电脑不能访问网页版、需要把 Visio 的 .vsdx 文件导入继续编辑、或者想批量把图表导出成图片放进文档。当前版本 31.3.2基于 Electron 42 构建。选对 Windows 安装包三种形态别装错如果你用 Windowsreleases 里会同时放出三个安装包区别在于安装范围和权限要求选错会被管理员权限卡住安装包安装位置是否需要管理员权限*-windows-installer.exeNSISProgram Files全机器需要*.msi当前用户目录不需要*-windows-no-installer.exe便携版免安装直接运行不需要但不注册文件关联公司电脑上没有管理员权限时直接用 MSI 或便携版。另外本地存储位置是固定的Windows 在C:\Users\用户名\AppData\Roaming\draw.io\macOS 在~/Library/Application Support/draw.io备份配置时去这里找。源码构建三步把 drawio-desktop 跑起来想改默认行为或验证新功能可以直接从源码启动不需要打安装包。前提是有 Node.js 22.12 以上官方构建用 Node 24。注意 draw.io 编辑器本体是 git 子模块clone 时必须加--recursive否则构建会失败git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm startnpm start会直接以开发模式启动应用。调试时可以加--enable-logging参数或设置DRAWIO_ENVdev打开 DevTools。一个容易踩的坑draw.io 只允许每个用户单实例运行如果官方正式版已在运行启动你的副本只会往正式版的窗口里开新标签——先退出所有 draw.io 再启动。用命令行批量导出图表桌面版自带 CLI 导出模式参数都定义在 src/main/args.js用--help能看全。输入除了 .drawio还支持 .vsdx、.csv、Mermaid.mmd/.mermaid输入可以是文件也可以是文件夹配--recursive递归子目录。几个常用参数drawio --export -f pdf diagram.drawio # 单文件导出 PDF drawio --export -r -o out/ ./charts # 递归导出目录输出到 out/几个细节导出多文件时输出必须是文件夹-p指定页码从 1 开始数v27.0.2 之前是 0 开始老脚本要注意-t让 PNG/SVG 背景透明-a把 PDF/HTML 的所有页都导出-e可在导出图片里嵌入原始图表数据方便后续再编辑。离线与数据安全它实际做了什么README 里对安全有明确承诺可以对照验证Content Security Policy 禁止运行远程加载的 JavaScript应用自身网络请求被限制为指向自己图表数据不会外传也没有任何使用统计上报。想彻底关掉启动时的更新检查设置环境变量DRAWIO_DISABLE_UPDATEtrue或启动时加--disable-update这对统管机器的内网部署很实用。有一个例外要知道图表里如果引用了外部图片、字体等 URL 资源打开时仍会发起请求以正确渲染这会把你的 IP 暴露给那台服务器不会传图表内容本身。来源不明的文件建议先在隔离环境里打开一次。常见坑排查clone 后启动报错找不到编辑器代码多半是漏了--recursive补一句git submodule update --init即可。启动副本却弹出现在有窗口里单实例限制见上文先退出官方版本。改完代码没生效npm start读的是源码树确认你改的是src/main/下的文件而不是 node_modules 里的副本。个人构建想打包成安装包设置DRAWIO_UNSIGNEDtrue跳过代码签名但产物是未签名的系统会拦截提示且不支持官方支持详见 doc/BUILDING_FOR_PERSONAL_USE.md 里 macOS/Windows/Linux 的具体命令。想持续跟踪上游合并前先git checkout -- package.json src/main/disableUpdate.js因为这两个文件会被构建脚本重写直接合并会被 git 拒绝。完整的构建与发布流程另有 DEVELOPMENT.md 和 doc/RELEASE_PROCESS.md 可以参考。对于普通用户其实直接下预编译安装包就够了——上面的源码路线留给需要二次定制的人。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 draw.io 桌面版上手指南：安装、命令行导出与常见坑
draw.io 桌面版上手指南安装、命令行导出与常见坑【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktopdraw.io 桌面版drawio-desktop是基于 Electron 封装的官方桌面绘图工具把 draw.io 网页编辑器装进了本地应用支持离线打开和编辑 .drawio、.vsdx、Mermaid 等文件也能通过命令行批量导出 PDF、PNG、SVG。读完这篇你会知道该选哪个安装包、怎么从源码跑起来以及它的安全边界在哪里。桌面版是什么适合谁用它和浏览器版的功能基本一致但有两个关键区别所有数据留在本机不需要登录账号就能保存文件应用默认与互联网隔离只有更新检查会联网。Apache 2.0 协议免费商用。典型使用场景内网电脑不能访问网页版、需要把 Visio 的 .vsdx 文件导入继续编辑、或者想批量把图表导出成图片放进文档。当前版本 31.3.2基于 Electron 42 构建。选对 Windows 安装包三种形态别装错如果你用 Windowsreleases 里会同时放出三个安装包区别在于安装范围和权限要求选错会被管理员权限卡住安装包安装位置是否需要管理员权限*-windows-installer.exeNSISProgram Files全机器需要*.msi当前用户目录不需要*-windows-no-installer.exe便携版免安装直接运行不需要但不注册文件关联公司电脑上没有管理员权限时直接用 MSI 或便携版。另外本地存储位置是固定的Windows 在C:\Users\用户名\AppData\Roaming\draw.io\macOS 在~/Library/Application Support/draw.io备份配置时去这里找。源码构建三步把 drawio-desktop 跑起来想改默认行为或验证新功能可以直接从源码启动不需要打安装包。前提是有 Node.js 22.12 以上官方构建用 Node 24。注意 draw.io 编辑器本体是 git 子模块clone 时必须加--recursive否则构建会失败git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop npm install npm startnpm start会直接以开发模式启动应用。调试时可以加--enable-logging参数或设置DRAWIO_ENVdev打开 DevTools。一个容易踩的坑draw.io 只允许每个用户单实例运行如果官方正式版已在运行启动你的副本只会往正式版的窗口里开新标签——先退出所有 draw.io 再启动。用命令行批量导出图表桌面版自带 CLI 导出模式参数都定义在 src/main/args.js用--help能看全。输入除了 .drawio还支持 .vsdx、.csv、Mermaid.mmd/.mermaid输入可以是文件也可以是文件夹配--recursive递归子目录。几个常用参数drawio --export -f pdf diagram.drawio # 单文件导出 PDF drawio --export -r -o out/ ./charts # 递归导出目录输出到 out/几个细节导出多文件时输出必须是文件夹-p指定页码从 1 开始数v27.0.2 之前是 0 开始老脚本要注意-t让 PNG/SVG 背景透明-a把 PDF/HTML 的所有页都导出-e可在导出图片里嵌入原始图表数据方便后续再编辑。离线与数据安全它实际做了什么README 里对安全有明确承诺可以对照验证Content Security Policy 禁止运行远程加载的 JavaScript应用自身网络请求被限制为指向自己图表数据不会外传也没有任何使用统计上报。想彻底关掉启动时的更新检查设置环境变量DRAWIO_DISABLE_UPDATEtrue或启动时加--disable-update这对统管机器的内网部署很实用。有一个例外要知道图表里如果引用了外部图片、字体等 URL 资源打开时仍会发起请求以正确渲染这会把你的 IP 暴露给那台服务器不会传图表内容本身。来源不明的文件建议先在隔离环境里打开一次。常见坑排查clone 后启动报错找不到编辑器代码多半是漏了--recursive补一句git submodule update --init即可。启动副本却弹出现在有窗口里单实例限制见上文先退出官方版本。改完代码没生效npm start读的是源码树确认你改的是src/main/下的文件而不是 node_modules 里的副本。个人构建想打包成安装包设置DRAWIO_UNSIGNEDtrue跳过代码签名但产物是未签名的系统会拦截提示且不支持官方支持详见 doc/BUILDING_FOR_PERSONAL_USE.md 里 macOS/Windows/Linux 的具体命令。想持续跟踪上游合并前先git checkout -- package.json src/main/disableUpdate.js因为这两个文件会被构建脚本重写直接合并会被 git 拒绝。完整的构建与发布流程另有 DEVELOPMENT.md 和 doc/RELEASE_PROCESS.md 可以参考。对于普通用户其实直接下预编译安装包就够了——上面的源码路线留给需要二次定制的人。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考