先区分三种图片来源#

第一种是 public 目录下的静态资源，适合头像、站点图标、通用截图。第二种是文章同目录资源，适合只服务于某一篇文章的图片。第三种是远程图片，适合临时引用，但长期可靠性最差。

如果一张图是文章理解的关键，不建议只引用外链。外链失效后，文章会失去上下文。

路径书写规则#

• 站点公共资源使用从根路径开始的地址，例如 /images/demo.png。

• Markdown 中尽量避免 Windows 反斜杠路径，例如 C:\Users\...。

• 文件名使用英文、数字和短横线，减少空格、中文和特殊符号导致的编码问题。

• 同一篇文章多张图，可以放到同一个主题目录里。

迁移旧文章时怎么查#

迁移文章后，我会先搜索 ![]( 找出所有 Markdown 图片引用，再逐个检查本地文件是否存在。对于线上页面，还要打开开发者工具看图片请求是否返回 200。

1
rg -n "!\[.*\]\(" src/content/posts
2
find public -type f | sort | head

发布前检查#

• 页面首屏图片能否加载。

• 图片尺寸是否过大，是否需要压缩。

• 文件名大小写是否和引用完全一致，Linux 服务器区分大小写。

• 文章迁移后是否仍然引用了旧域名或旧端口。

实战复盘#

把《博客图片路径整理笔记》真正用起来，我会在发布后回到站点里看三个位置：文章页、分类页和搜索结果。文章页看正文是否完整，分类页看它是否进入正确栏目，搜索结果看标题和摘要是否能被关键词命中。

如果这篇文章后续被修改，我会保留原始发布时间，只改正文和摘要。这样归档时间不会被频繁扰动，读者也能看出这篇内容是在哪个阶段整理出来的。

这类博客维护文章的验收标准不是“能不能发布”，而是以后遇到同类问题时，能不能按文章里的检查清单快速完成一次操作。

最小验收样例#

验收《博客图片路径整理笔记》时，我会选一篇真实文章或一个真实页面作为样例，而不是只看源码。先确认页面能打开，再确认列表、分类、归档、搜索这些入口都能找到它。

如果文章讲的是站点维护，还要记录修改前后差异：改了哪个文件、构建产物是否更新、线上 HTTP 状态码是多少。这样后面出问题时，可以直接回到这次验收记录。

小结#

图片路径最好在写文章时就规范下来。等文章数量变多后，再统一修复失效图片，会比修正文案麻烦得多。