必须安装hediet.drawio-diagrams插件（作者hediet、版本≥1.7.0），手动配置"files.associations": {"*.drawio": "drawio"}，并使用draw.io: open diagram命令，三者缺一不可，否则仅显示xml源码。
装对插件、配好后缀、用对命令——三者缺一不可，否则你点开的永远是 XML 源码，不是图形编辑器。
该装哪个 Draw.io 插件？认准 hediet.drawio-diagrams
VS Code 扩展市场里搜 “Draw.io Integration”，会出现多个同名插件。必须选作者是 hediet、ID 为 hediet.drawio-diagrams 的那个。它已取代旧版 vscode-drawio（作者 jgraph，已停更），后者在 VS Code 1.80+ 上大概率白屏或强制跳转浏览器。
- 安装后务必重启 VS Code，否则右键菜单不会出现
Open Diagram，命令面板也搜不到相关命令 - 检查是否装对：打开扩展面板 → 点击插件详情 → 确认
Publisher是hediet，版本 ≥ 1.7.0 - 国内用户若 Marketplace 安装失败，可去 GitHub releases 下载
drawio-diagrams-1.7.0.vsix，再通过Extensions: Install from VSIX手动安装
为什么双击 .drawio 文件只显示 XML？补上 files.associations 配置
插件不会自动接管文件类型。VS Code 默认把 .drawio 当纯文本处理，必须显式告诉它：“这类文件交给 drawio 语言服务渲染”。
- 打开 VS Code 设置（
Cmd+, / Ctrl+,），搜索settings.json，点击“在 settings.json 中编辑” - 添加这一行：
"files.associations": { "*.drawio": "drawio" } - 保存后重启，或至少重载窗口（
Ctrl+R / Cmd+R） - 新建文件时必须带
.drawio后缀（如flow.drawio），不能是.xml、.md或.diagram—— 即使内容合法也不触发内嵌编辑器
打不开图形界面？绕过双击，直接用命令面板调起
双击行为在多工作区、Git 子模块等场景下不稳定。最可靠的方式是跳过文件关联，直奔插件核心命令。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Draw.io: Create New Diagram→ 保存为本地.drawio文件 - 已有 XML 内容？新建空
.drawio文件 → 粘贴 XML → 按Ctrl+Enter（Windows/Linux）或Cmd+Enter（macOS）强制解析（不是Ctrl+S） - 想在 Markdown 里嵌图？写一个
```drawio```代码块，然后执行Draw.io: Open Diagram from Code Block
导出 PNG 模糊、中文乱码？关键参数得手动开
内嵌编辑器基于 Web View 渲染，不读系统字体，且默认用 1x 缩放。模糊和乱码不是 bug，是默认策略导致的，必须主动干预。
- 导出前先调高缩放：右键画布 →
Zoom→ 设为200%或300% - 导出对话框中务必勾选
Use device pixel ratio（清晰度核心开关）和Include a copy of the diagram（确保 SVG 含内联样式） - 中文不乱码：避免用 “微软雅黑”“思源黑体”；在样式栏（
Arrange → Insert → Advanced → Style）手动加fontFamily=Helvetica;fontSize=14;; - 高分屏下仍发虚？改用
Verdana或Segoe UI，并在样式中显式声明fontFamily=Verdana
最容易被忽略的是：导出清晰度和字体表现，跟 VS Code 主题或系统设置无关，只取决于画布缩放 + 导出选项 + 样式字符串这三处手动配置。没动这三项，光调 VS Code 设置毫无作用。
