装对excalidraw插件需在vscode扩展面板搜“excalidraw editor”，只认发布者为excalidraw官方组织的版本；新建文件必须保存为.xxx.excalidraw后缀，保存后自动进入画布编辑视图。
VSCode 里装好 Excalidraw 插件后，直接新建 .excalidraw 文件就能画图，不需要额外配置服务器或编译代码。
怎么装对的插件（别被非官方版本坑）
打开 VSCode 扩展面板（Ctrl+Shift+X），搜 Excalidraw Editor，只认准发布者是 excalidraw 官方组织的那一个。其他名字相近但发布者不是它的，比如带“Lite”“Pro”“AI”字样的，大概率功能不全、JSON 结构不兼容，或者偷偷上传你的画布数据。
- 装完重启 VSCode，确保插件激活
- 检查设置里有没有多出
Excalidraw相关配置项——没有也正常，它默认开箱即用 - 如果新建文件时没语法高亮或预览，说明插件没生效，重装一次并确认禁用了所有冲突插件（比如某些旧版 Markdown 预览工具）
新建文件后为啥打不开画布？
VSCode 默认不会自动识别 .excalidraw 后缀为可编辑画布，必须手动创建一个空文件并保存为正确扩展名：
- 按
Ctrl+N新建空白文件 →Ctrl+S保存 → 输入文件名如api-flow.excalidraw（结尾必须是.excalidraw，不能是.excalidraw.json或.excalidraw.svg） - 保存后，VSCode 会自动切换到 Excalidraw 编辑器视图；如果还是文本编辑器，右下角点击语言模式，选
Excalidraw - 首次打开可能卡顿 1–2 秒——它在加载 Canvas 渲染引擎，不是卡死
画完图怎么导出/嵌入文档？
Excalidraw 在 VSCode 里生成的是纯 JSON，但你可以按需导出为多种格式，关键看用途：
- 想插入 Markdown：右键画布 →
Export to PNG或Export to SVG，然后在.md里写；SVG 更推荐，缩放不失真，体积小 - 想保留可编辑性：直接提交
.excalidraw文件到 Git，同事拉下来双击就能继续改——别转成 PNG 就丢编辑能力了 - 导出 SVG 后发现文字模糊？那是浏览器渲染问题，不是插件 bug；用 Chrome 或 Edge 打开 SVG 文件查看效果更准
协作和同步要注意什么
VSCode 插件默认只支持本地编辑，多人实时协作需要额外部署服务端，但日常单人使用完全不用碰这个：
- Git 提交
.excalidraw文件时，diff 是可读的 JSON，能看清谁改了哪个矩形的x坐标 - 不要把
.excalidraw文件和.png一起提交——PNG 是衍生品，CI 流水线里用脚本自动生成更可靠 - 如果团队共用同一份架构图，建议在仓库根目录建
docs/architecture/专门放这些文件，避免散落在各人本地
真正容易被忽略的点是：VSCode 插件不自动保存草稿，关窗口前务必手动 Ctrl+S；它也不会像网页版那样定时 autosave，一次忘记就真没了。
