粘贴截图后图片不显示，需检查pasteImage.path路径配置是否合法：必须为相对路径（如assets/images）、目录需手动创建、末尾不加斜杠；且仅在Markdown文件的文本编辑模式下生效。
粘贴截图后图片不显示？检查 pasteImage.path 路径配置是否合法
默认情况下，Paste Image 插件会把截图存到当前工作区根目录下的 images/ 文件夹，但如果你没开工作区、或路径含中文/空格/特殊符号，它可能静默失败——粘贴时看似成功，实际没生成文件，Markdown 里只留个空 ![]()。
实操建议：
- 打开 VSCode 设置（
Ctrl+,），搜pasteImage.path，设为相对路径如./assets/images，确保该目录存在（插件不会自动创建） - 避免用
~/或绝对路径，Windows 下C:\xxx和 macOS 下/Users/xxx都不被支持 - 路径末尾不要加斜杠，写成
assets/images而非assets/images/，否则可能生成assets/images//xxx.png
Markdown 中粘贴失败，确认文件扩展名和编辑器焦点状态
插件只在 Markdown 文件（.md 后缀）且编辑器处于「文本编辑模式」时响应 Ctrl+V。如果光标停在代码块里、数学公式中、或当前文件被识别为 plaintext，粘贴会直接走系统默认逻辑，不触发截图保存。
常见错误现象：
- 粘贴后出现 base64 编码的
data:image/png;base64,...—— 这是浏览器行为，说明插件根本没接管 - 右键菜单里没有「Paste Image」选项 —— 检查是否在
.md文件中，且未启用其他冲突插件（如Markdown All in One的快捷键覆盖） - 截图存到了别处（比如
~/Downloads）—— 可能是系统级截图工具（如 Snipaste、微信截图）干扰了剪贴板格式，建议用系统自带截图（Win+Shift+S/Cmd+Shift+4）
pasteImage.fileNameFormat 怎么设才不撞名？
默认用时间戳命名（image-1712345678901.png），看着安全，但多人协作或频繁编辑时，同一秒内多次粘贴仍可能覆盖。更稳妥的是混入文件名和序号。
推荐配置（在 settings.json 中）：
"pasteImage.fileNameFormat": "${filename}-${datetime:YYYYMMDD-HHmmss}-${counter}"说明：
-
${filename}是当前 Markdown 文件名（不含后缀），避免跨文档重名 -
${counter}是自增数字，解决同秒多次粘贴问题 - 不要用
${random}—— 它不保证唯一性，且部分版本不支持 - 如果路径含
${filename}，务必确保当前文件已保存（有真实文件名），否则会退化成untitled-1
导出 HTML 或 PDF 时图片丢失？路径不是相对就行
插件插入的是相对路径链接（如 ），但导出工具（如 markdown-pdf 或 Typora）默认只解析当前文件同级及子目录。若你把图片存到 ../images/，导出大概率报 File not found。
关键点：
- 所有图片路径必须是当前
.md文件的**同级或子目录**，不能向上越级 - 导出前手动检查链接：按
Ctrl+Click点击图片链接，看能否在 VSCode 里打开对应文件 - 如果要用统一图库，建议把
assets/images放在每个项目根目录，而不是用户主目录——后者导出时路径无法映射
最易被忽略的是：插件配置改了，但旧图片链接还是老路径，得手动批量更新，或者删掉 assets/images 重来一次。
