draw.io插件打不开图形编辑器是因为入口错误、插件选错或文件关联未配置；需安装hediet版≥1.5.0、配置"files.associations"、用右键或命令面板打开；关闭自动预览和云端同步可解决卡顿与导出模糊；中文显示异常需手动设置fontfamily和fontsize；协作时须保存为本地文件而非云链接。
VSCode 里装了 Draw.io 插件却打不开图形编辑器？不是插件坏了，而是你没走对入口——它不靠双击触发，也不认错的后缀或配置，必须用右键菜单或命令面板显式调起。
Draw.io 插件打不开图形界面？检查这三件事
绝大多数人卡在这一步：双击 .drawio 文件只看到 XML 源码，或者右键没有 Open Diagram。根本原因就三个：
- 装错了插件：必须选作者是 Hediet、版本 ≥ 1.5.0 的
drawio（不是 jgraph 旧版，也不是已停更的drawio-editor） - 没配文件关联：在
settings.json里加这一行："files.associations": {"*.drawio": "drawio"}，然后重启 VSCode - 没走正确入口：双击行为不稳定，尤其在子工作区或 Git 子模块中；务必右键文件 →
Open Diagram，或按Ctrl+Shift+P→ 输入Draw.io: Open Diagram
编辑卡顿、缩放失灵、导出图糊？关掉这两个开关
Draw.io 插件默认开启实时预览和云端同步，本地大图（比如含 50+ 节点或 SVG 图标）会拖慢 VSCode，甚至白屏。这不是性能问题，是功能开关没关：
- 进设置搜
drawio.preview.autoRefresh，设为false - 搜
drawio.sync.enabled，也设为false
关掉后，编辑响应变快，缩放流畅，导出时也能手动控制分辨率——导出前先右键画布 → Zoom → 设为 200%，再执行 Export as → PNG 并勾选 Use device pixel ratio，文字边缘才不发虚。
导出中文乱码、字体变小？别碰系统字体，改图内样式
Draw.io for VSCode 是沙箱化 Web View，不读系统字体。导出时回退成宋体或文字变小，不是 VSCode 设置问题，而是图内没指定基础样式：
- 选中节点 → 右键 →
Style→ 手动加fontFamily=Helvetica;fontSize=14;（避免用“微软雅黑”“思源黑体”等本地字体名） - 导出 SVG 时务必勾选
Include a copy of the diagram，否则样式丢失，文字变英文 - 如果仍需高清 PNG 且要中文，直接导出 SVG 更可靠——矢量格式无损缩放，VSCode 预览和 Markdown 均原生支持
协作时同事打不开你的图？检查是否存成了“云链接”
新建图时若误点了 From Cloud 或 From Template，生成的是带 https://draw.io/ 的在线链接，本地没网就打不开，Git 也 track 不了内容。必须确认：
- 新建图走
Draw.io: Create New Diagram→ 选Blank Diagram (Local) - 保存后检查文件头：开头应是
<mxgraphmodel dx="</code"> 这类 XML，而不是 <code>{"xml":"<mxgraphmodel...></mxgraphmodel...> - Git 提交前运行
git diff：应看到 XML 内容变更，而非仅时间戳变化；若只有 mtime 改了但内容没变，说明 diagrams.net 没真正写回文件，得切回 VSCode 按Cmd+R强制重载
最易被忽略的一点：插件不监听文件系统变更，浏览器中保存后 VSCode 不自动刷新——你得手动重载，否则看到的永远是旧图。
