VSCode 不直接配置 VuePress 环境，关键在于 Paste Image 插件路径与 VuePress 静态资源规则对齐：Path 设为 .vuepress/public/images/${filename}${ext}，Prefix 设为 /images/，并关闭 Copy relative path，否则构建后图片 404。
VSCode 本身不直接“配置 VuePress 环境”，而是通过插件、路径约定和终端命令协同工作；真正关键的是让 Paste Image 插件生成的图片路径与 VuePress 的静态资源解析规则对齐——否则本地能看，构建后全 404。
为什么图片在 VuePress 中容易 404？
VuePress 构建时只把 .vuepress/public/ 下的文件原样复制进 dist/，而 Markdown 里写的  是相对路径，实际解析依赖当前 .md 文件的位置和构建后的 URL 结构。
- 比如
docs/guide/intro.md引用，会被解析为/guide/images/logo.png，但该路径下根本没这个文件 -
.vuepress/public/images/logo.png实际对应的是根路径/images/logo.png，所以正确写法应是 - 手动改每个链接太累，必须靠
Paste Image插件自动输出符合规则的路径
Paste Image 插件的 Path 和 Prefix 必须这样配
打开 VSCode 设置（Ctrl+,），搜索 Paste Image，找到以下两项：
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
-
Path填：.vuepress/public/images/${filename}${ext}—— 确保图片存到 VuePress 认可的静态资源目录 -
Prefix填：/images/—— 这样粘贴后自动生成，和.vuepress/public/images/完全匹配 - 取消勾选
Copy relative path（它会生成./images/这类相对路径，VuePress 构建时无法映射） - 如果项目 docs 不在根目录（比如是
src/docs），则Path要相应调整为src/docs/.vuepress/public/images/${filename}${ext}
package.json 脚本要指向正确的 docs 目录
VuePress 默认查找 docs/，如果你的文档放在其他位置（如 src/docs 或 content/），dev 和 build 脚本必须显式指定：
立即学习“前端免费学习笔记（深入）”；
-
"docs:dev": "vuepress dev docs"→ 如果 docs 在根目录 -
"docs:dev": "vuepress dev src/docs"→ 如果 docs 在src/下 - 不写路径参数，默认找当前目录下的
docs/，找不到就报错Cannot find directory: docs - 构建命令同理：
vuepress build src/docs才会把src/docs/.vuepress/public/下的资源正确打包进去
别忽略 .vuepress/config.js 的 publicDir 配置
虽然默认就是 .vuepress/public，但如果你改过它（比如设成 publicDir: 'static'），那 Paste Image 的 Path 和 Prefix 就必须同步更新：
-
Path得改成static/images/${filename}${ext} -
Prefix得改成/images/（前提是static/在构建后仍挂载在根路径）或/static/images/（如果static目录被整体复制） - 一旦 config.js 里动了
publicDir，所有图片路径逻辑都要重验，这是最常被跳过的检查点
