vscode中draw.io插件安装失败需检查marketplace连接与签名验证，文件需为.drawio后缀，导出png前应调高缩放至200%以上，协作时统一utf-8+lf编码。
VSCode 里装不上 Draw.io 插件？检查 Marketplace 连接和插件签名
Draw.io 官方插件（drawio-diagrams）在 VSCode 1.85+ 版本中默认启用 Marketplace 签名验证，如果网络无法访问 marketplace.visualstudio.com 或证书链异常，插件会显示“安装失败”但无明确报错。
- 先打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入并执行Developer: Toggle Developer Tools，切换到 Console 标签页，看是否有ERR_CONNECTION_REFUSED或net::ERR_CERT_AUTHORITY_INVALID - 国内用户可临时设置代理：在 VSCode 设置中搜索
http.proxy，填入可用 HTTP 代理地址；或改用离线安装方式——去 GitHub releases 页面下载最新.vsix文件（如drawio-diagrams-1.7.0.vsix），再通过命令面板执行Extensions: Install from VSIX... - 别装错名字：第三方有叫
draw.io（无连字符、已弃用）、vscode-drawio（老版、不维护）等，只认准官方发布的drawio-diagrams
画图时双击打不开编辑器？确认文件关联和后缀名
Draw.io 插件默认只对 .drawio 和 .dio 后缀文件激活。如果你新建了 flowchart.md 或 uml.xml，即使内容是 valid draw.io XML，双击也不会启动内嵌编辑器。
- 新建图的正确姿势：右键资源管理器 →
New File→ 输入xxx.drawio（必须带后缀）→ 双击打开 → 自动进入绘图界面 - 已有 XML 内容想复用？复制全部内容 → 新建空
.drawio文件 → 粘贴 → 按Ctrl+Enter（Windows）或Cmd+Enter（macOS）触发解析（不是 Ctrl+S） - 不要手动改后缀：把
diagram.png.drawio改成diagram.drawio是 OK 的；但改成diagram.png后双击只会预览图片，不会进编辑器
导出 PNG 模糊、文字发虚？调整缩放和导出 DPI
VSCode 内嵌的 draw.io 渲染器默认使用 1x 缩放，直接导出 PNG 会丢失亚像素信息，尤其小字号文字边缘锯齿明显，这不是 VSCode 问题，而是底层 mxGraph 渲染策略导致。
- 导出前务必先在编辑器右上角点击
Zoom下拉菜单，选200%或更高（推荐300%）→ 再点File → Export as → PNG - 导出对话框里勾选
Transparent background和Include a copy of the diagram（后者确保 XML 嵌入，方便后续修改） - 如果仍模糊，说明图中用了非矢量字体（比如系统未安装的
Helvetica Neue），改用Verdana或Segoe UI并在样式栏手动设为fontFamily=Verdana
协作时别人打不开你的 .drawio 文件？XML 编码和换行符要统一
Draw.io 文件本质是 XML，但 VSCode 插件保存时默认用 UTF-8 + LF 换行，若在 Windows 上用记事本另存、或 Git 配置了 core.autocrlf=true，可能混入 \r\n 导致解析失败，错误提示常为 Invalid XML: unexpected token。
- 在 VSCode 中右下角确认状态栏显示
UTF-8和LF（不是CRLF）；点击可切换 - Git 用户建议项目根目录加
.gitattributes，写入：*.drawio text eol=lf - 别用外部工具压缩：有人为减体积把
.drawio用 ZIP 打包再传，但 draw.io 插件只识别纯 XML 文件，解压后也得确保无 BOM 头（VSCode 默认不加，但某些编辑器会）
Draw.io 在 VSCode 里最麻烦的从来不是功能少，而是它安静地依赖一堆隐性约定：后缀、编码、缩放、网络、签名——哪一环断了都不报大错，只默默拒绝工作。改完配置记得重启 VSCode，不是重载窗口。
