默认打开.drawio文件提示“无法连接到 draw.io”是因为插件通过iframe加载在线服务，断网或网络受限时白屏；需安装draw.io desktop并启用本地服务（如http://localhost:8000/?embed=1&proto=json），再配置vscode的drawio.integration.url，方可实现真正离线编辑。
为什么默认打开.drawio文件会提示“无法连接到 draw.io”
因为插件默认通过 iframe 加载 https://app.diagrams.net，完全依赖网络。断网、企业防火墙拦截、或 draw.io 官方服务临时不可用时，编辑器直接白屏，报错信息通常是 Failed to load resource: net::ERR_INTERNET_DISCONNECTED 或类似 CORS 错误。
如何配置本地 draw.io 服务实现真正离线
不能只改设置里的 drawio.integration.url —— 必须先让本地有一个可访问的 draw.io 实例。官方推荐路径是使用 draw.io Desktop 启动内置服务：
- 下载并安装最新版 draw.io Desktop（macOS/Windows/Linux 均支持）
- 首次启动后，在菜单栏点击
Draw.io → Preferences → Enable local server，勾选并设置端口（默认8000） - 确认服务已运行：在浏览器中访问
http://localhost:8000/?embed=1&proto=json，应看到空白但无报错的嵌入式界面 - 在 VSCode 设置中搜索
drawio.integration.url，填入上述完整 URL（注意保留?embed=1&proto=json） - 重启 VSCode 或重载窗口（
Cmd+Shift+P→Developer: Reload Window）
离线模式下哪些功能会受限
本地服务能覆盖绝大多数绘图需求，但以下几点容易被忽略：
-
导出为 PDF在部分本地部署版本中不可用（因依赖服务端渲染），建议改用Export As → SVG+ 浏览器另存为 PDF - 某些字体（如 Inter、IBM Plex）可能 fallback 到系统默认字体，需在
Style面板手动指定fontFamily=Verdana等安全字体 - “从 Google Drive / OneDrive 导入”类云集成功能彻底失效，但本地
.drawio/.xml文件导入不受影响 - 右键菜单中的
Copy as PNG可能失灵，优先使用顶部菜单File → Export As → PNG
验证是否真的离线可用
最可靠的验证方式不是看能否打开文件，而是关掉 Wi-Fi / 拔掉网线后操作：
- 新建一个
test.drawio文件，双击打开 - 拖一个
Process形状到画布，双击编辑文字，按Ctrl+Z撤销 —— 所有交互必须实时响应 - 右键画布 →
Export As → SVG，保存成功且图像内容完整 - 关闭 VSCode，重新打开，再次进入该文件，确认上次编辑的文字和布局仍在
只要这四步全通，说明离线链路已闭环。真正的难点不在配置，而在于本地服务进程是否持续存活——桌面版 draw.io 最小化后常被系统休眠策略终止，建议将其加入开机自启或保持窗口常驻。
