VSCode如何使用Draw.io画流程图_VSCode Draw.io画流程图技巧

VSCode 里直接用 Draw.io 画流程图是可行的，但不是开箱即用——必须装插件，且默认不支持本地离线编辑 .drawio 文件（会跳转浏览器）。

应安装 Draw.io Integration（作者 Hediet，版本≥1.5.0），右键文件选“Open Diagram”打开编辑，导出PNG时需勾选“Use device pixel ratio”并可调缩放提升清晰度，Markdown中嵌入需用特定代码块语法且不自动回写。

装哪个插件？Draw.io Integration 还是 Diagrams.net Integration？

这里有个关键选择：只装 Draw.io Integration，并且认准作者是 Hediet。市场上同名插件不少，但旧版（比如作者是 jgraph 的 drawio-vscode）已经停止维护了，用它打开文件只会强制跳转到浏览器，完全失去了在编辑器内直接操作的便利。

新版插件其实已经更名为 Diagrams.net Integration，但在插件市场里搜索时，它仍然显示为“Draw.io Integration”。安装时务必核对发布者是 Hediet，并且版本号最好不低于 1.5.0。这个版本支持了 VSCode 内嵌编辑器、实时预览、完整的撤销重做（Ctrl+Z）、缩放以及导出 PNG 或 SVG 等核心功能。

对了，安装后记得重启一下 VSCode，否则右键菜单里很可能不会出现那个至关重要的“Open Diagram”选项。

如何打开和编辑 .drawio 文件？

打开方式有点反直觉，不能直接双击，也不能把文件拖进编辑区——必须右键点击文件，然后选择 Open Diagram。这一步是新手最容易卡住的地方。

如果右键菜单里没有这个选项，大概率是插件没有正确激活或者文件关联失败了。这时候可以尝试手动调出命令面板（Ctrl+Shift+P），然后输入 Draw.io: Open Diagram 来执行。

首次打开文件时，系统通常会询问是否启用自动保存，强烈建议勾选。否则，画到一半直接关闭标签页，未保存的内容可就找不回来了。编辑器底部状态栏会显示当前的缩放比例、页面尺寸和网格开关等信息，点击这些状态图标可以快速进行调整。

为什么画完导出的 PNG 模糊？怎么调清晰度？

导出图片模糊是个高频问题。默认的导出设置使用的是 1x 渲染，在高分辨率屏幕上看起来就会明显发虚。解决这个问题需要手动调整导出参数，注意，这可不是在 VSCode 的主设置里改，而是调整插件内部的导出逻辑。

具体操作分几步：导出前，先按 Ctrl+Shift+P 打开命令面板，执行 Draw.io: Export As 并选择 PNG 格式。接下来会弹出一个导出对话框，在这里，一定要勾选上 Use device pixel ratio 这个选项，这是保证清晰度的关键。

如果勾选后觉得清晰度还是不够，可以在导出前，先右键点击画布，选择 Zoom，将画布缩放比例设为 200% 甚至更高，然后再进行导出。这相当于提升了渲染的分辨率。当然，如果对清晰度要求极高，直接导出为 SVG 格式是更一劳永逸的办法，矢量格式天生就适合嵌入文档或网页。

能不能像 Typora 那样在 Markdown 里嵌入 drawio 图形？

可以嵌入，但体验上并非“实时渲染”，需要配合特定的语法和插件功能来实现。

在 Markdown 文件中，你需要用特定的代码块语法包裹图形的 base64 编码内容，格式如下：

```drawio
...
```

这里需要注意，安装一般的 Markdown Preview Mermaid Support 这类插件是无效的。必须依赖 Draw.io Integration 插件自带的能力：在写好的代码块上右键，选择 Draw.io: Open Diagram from Code Block 来打开编辑。

还有一个不便之处：修改图形后，代码块里的 XML 内容不会自动更新，需要手动复制粘贴回去。因此，更稳妥的做法是把流程图单独保存为 .drawio 文件，然后在 Markdown 里用 ![](xxx.drawio) 的格式引用。不过，VSCode 本身并不会解析这个链接来显示图片，它主要起一个标记和关联的作用。

真正麻烦的还在后面：跨设备同步。.drawio 文件本质上是 XML，里面可能包含了相对路径、字体引用，甚至本地图片的 base64 编码。换一台电脑打开，样式或图形元素丢失是常有的事。别指望它能“开箱即用”，每次迁移工作环境前，最好先检查一下文件里 根节点下的 dx/dy 和 gridSize 等参数是否异常。