如何用 Codex 检查站内链接是否混乱

为什么站内链接混乱会拖累 SEO 和转化

很多网站做 SEO 时，会盯着标题、关键词、外链和文章数量，但忽略一个更基础的问题：站内链接是否清晰。站内链接一旦混乱，搜索引擎和真实用户都会迷路。页面明明存在，却没有稳定入口；重要页面明明想排名，却没有足够的内部推荐；文章之间明明主题相关，却没有形成专题路径。

站内链接不是简单地“多加几个链接”。它决定了三个关键问题：用户从哪里进入、下一步应该去哪里、搜索引擎如何理解页面之间的关系。一个混乱的内链结构，会让高价值页面变成孤岛页，让低价值页面抢走导航入口，让同一类内容分散在不同路径里，最后表现为收录慢、排名弱、跳出高、转化断层明显。

用 Codex 检查站内链接的价值在于，它可以直接读取项目里的路由文件、页面组件、导航配置、Markdown/MDX 内容、CMS 数据结构、sitemap 生成逻辑和测试脚本，把“页面之间到底怎么互相连接”梳理出来。人工靠点页面很容易漏掉隐藏入口，Codex 更适合做全局扫描和结构化归纳。

什么样的内链结构才算清晰

清晰的站内链接结构，首先不是链接数量多，而是层级、语义和目标一致。用户看到一个链接时，应该能预期点进去会看到什么；搜索引擎看到一组链接时，应该能理解哪些页面是核心页，哪些页面是支撑页，哪些页面只是辅助页。

Codex 适合检查哪些站内链接问题

Codex 适合处理代码库里的结构化检查，尤其是那些分散在不同文件中的链接问题。它不只是看页面 UI，而是可以顺着代码找到链接来源、目标路径、组件复用关系和路由生成逻辑。

• 检查导航、页脚、侧边栏、面包屑里的链接是否重复、缺失或指向错误。

• 检查文章、案例、专题页里的内部链接是否足够、是否主题相关、锚文本是否明确。

• 检查 sitemap、robots、动态路由和静态页面之间是否存在不一致。

• 检查是否有孤岛页：有页面文件或 CMS 内容，但没有任何页面链接到它。

• 检查是否有死链、旧链接、http 链接、重复路径、尾斜杠不一致和跳转链。

• 检查是否有重要页面被隐藏在过深层级，或者只通过按钮/脚本触发，缺少可爬取链接。

• 检查内链是否符合产品目标：服务页、价格页、注册页、咨询页是否被合理推荐。

需要注意的是，Codex 不应该替代 SEO 策略判断。它可以帮你找出结构问题、生成修复方案和修改代码，但哪些页面最重要、哪些关键词最值得做、哪些内容应该成为专题中心，仍然需要人工基于业务目标判断。

检查前需要准备什么上下文

直接对 Codex 说“帮我检查内链”太宽泛，容易得到一份泛泛的建议。更好的做法是先把检查范围、站点类型、核心转化目标、重要页面、技术栈和输出格式交代清楚。

第一步：让 Codex 生成全站链接地图

优化内链之前，先不要急着改。第一步应该是让 Codex 扫描项目，生成一份“全站链接地图”。这份地图不是给用户看的 sitemap，而是给你判断页面关系用的内部审计表。

请你只做站内链接审计，不要修改任何代码。 请扫描当前项目中的路由、页面组件、导航组件、页脚组件、文章/MDX/Markdown 内容、sitemap 生成逻辑和链接相关配置，帮我生成一份全站链接地图。 请输出： 1. 所有可访问页面路径 2. 每个页面的页面类型：首页 / 服务页 / 产品页 / 分类页 / 文章页 / 案例页 / 转化页 / 其他 3. 每个页面链接到了哪些站内页面 4. 每个页面被哪些页面链接到 5. 是否存在没有入口的孤岛页 6. 是否存在重复路径、旧路径、大小写不一致、尾斜杠不一致的问题 7. 涉及的文件路径 要求： - 只统计站内链接，不统计外链 - 区分普通 a 标签、Link 组件、导航配置、Markdown 链接和动态生成链接 - 先输出审计报告，不要直接修改代码

这一步的重点是把网站从“页面集合”变成“链接网络”。如果 Codex 连页面之间的关系都没有梳理清楚，后面的优化建议通常不可靠。

第二步：检查导航、页脚和面包屑是否一致

导航、页脚和面包屑是站内链接里最稳定的入口。它们的问题很常见：顶部导航有一个服务名称，页脚又用另一个名称；移动端菜单少了核心页面；面包屑路径和真实目录不一致；旧页面已经下线，但页脚还保留旧链接。

请重点检查当前项目里的全局导航、移动端导航、页脚链接、侧边栏和面包屑。 请判断： 1. PC 导航和移动端导航是否一致 2. 顶部导航和页脚链接是否存在命名不一致 3. 重要页面是否只出现在某一个入口里 4. 面包屑是否能反映真实层级 5. 是否存在旧路径、404 路径、重复路径、大小写不一致路径 6. 是否有核心转化页没有稳定入口 请按表格输出： - 问题位置 - 当前链接文本 - 当前链接目标 - 问题类型 - 影响程度：高 / 中 / 低 - 建议修复方式 - 涉及文件

第三步：检查文章页和专题页的内链是否合理

文章页是最容易出现内链混乱的地方。很多内容站会在文章里随机加链接，或者只在结尾放几个“相关文章”。这种方式很难形成清晰的主题网络。更好的结构是：文章应该链接到上级专题页、相关解释页、下一步行动页，以及少量真正相关的文章。

请检查当前项目中的文章页、博客页、专题页和内容详情页的站内链接结构。 请重点判断： 1. 每篇文章是否链接到了对应的上级分类页或专题页 2. 是否存在文章之间完全没有互链的问题 3. 是否有主题无关的内链硬插入 4. 是否有大量重复锚文本，例如“点击这里”“查看详情” 5. 是否有文章应该链接到服务页、产品页、价格页或联系页，但目前没有链接 6. 是否有专题页没有向下链接到足够的支撑文章 请输出： - 文章路径 - 当前内链数量 - 推荐新增的内链目标 - 推荐锚文本 - 为什么推荐这个链接 - 是否属于 SEO 优先修复项

这里不要让 Codex 机械地“每篇文章加 5 个链接”。内链数量不是目标，主题相关性和用户下一步路径才是目标。

第四步：找出孤岛页、死链、重复入口和跳转链

站内链接审计里，最值得优先处理的是技术型问题。因为这类问题不会带来策略争议，发现就应该修：页面没人链接、链接指向 404、旧 URL 没迁移、新旧路径同时存在、http/https 混用、跳转链过长。

请对当前项目进行站内链接技术问题审计。 请检查： 1. 孤岛页：存在页面文件或可生成路由，但没有任何站内页面链接到它 2. 死链：站内链接指向不存在的页面、旧路径或 404 页面 3. 重复入口：同一内容存在多个不同 URL，例如 /about、/about/、/About 4. 跳转链：链接先跳到旧路径，再跳到新路径 5. 协议问题：http 和 https 混用 6. 动态路由问题：slug 生成和实际链接不一致 7. sitemap 问题：sitemap 里有页面，但站内没有入口；或者站内有入口，但 sitemap 缺失 请输出修复优先级： P0：会导致用户无法访问或搜索引擎抓取失败 P1：会影响权重集中或页面收录 P2：会影响体验但不阻断访问 P3：结构优化建议

第五步：让 Codex 生成内链修复方案

审计完成后，不要马上让 Codex 大面积修改。正确顺序是先让它输出修复计划，再让它按优先级分批修改。尤其是导航、slug、sitemap、重定向和文章内容链接，牵一发可能影响很多页面。

基于你刚才的站内链接审计结果，请先不要修改代码。 请生成一份内链修复方案，按 P0 / P1 / P2 / P3 分级。 每个修复项请包含： 1. 问题描述 2. 影响页面 3. 涉及文件 4. 推荐修改方式 5. 是否需要新增链接 6. 是否需要删除链接 7. 是否需要重定向或 canonical 调整 8. 风险说明 9. 修改后如何验证 要求： - 优先修复死链、孤岛页、重要页面无入口、sitemap 不一致 - 不要为了增加链接而堆砌链接 - 不要改变现有视觉布局，除非确实需要新增链接区域 - 如果需要修改导航结构，请先单独列为需要人工确认的事项

如果项目比较大，建议先让 Codex 修 P0 和 P1。P2、P3 更像结构优化，应该结合 SEO 策略、业务重点和内容规划一起判断。

第六步：把内链规则写进 AGENTS.md

站内链接混乱往往不是一次性问题，而是长期迭代造成的。今天修好了，后面新增页面、文章、专题、活动页时，如果没有规则，很快又会乱。所以应把内链规则沉淀进 AGENTS.md，让 Codex 以后修改项目时自动遵守。OpenAI 官方 Codex 文档建议把可复用的项目规则写进 AGENTS.md，Codex 会在开始工作前读取这些指令。

AGENTS.md - Internal Links Rules ## 站内链接原则 - 新增页面时，必须检查它是否有至少一个合理的站内入口。 - 重要页面不能只依赖文章正文里的偶然链接，必须有稳定入口，例如导航、页脚、分类页、专题页或相关模块。 - 所有站内链接必须使用项目统一的路径格式，不混用大小写、尾斜杠和旧路径。 - 站内链接优先使用语义清晰的锚文本，避免大量使用“点击这里”“了解更多”“查看详情”。 - 内容页应该优先链接到对应分类页、专题页、相关解释页和下一步转化页。 - 不允许为了 SEO 堆砌无关内链。每个新增内链必须能解释用户为什么需要点击它。 ## 修改前检查 - 如果修改导航、页脚、面包屑、slug、sitemap、redirects 或 canonical，必须先列出影响范围。 - 如果新增文章或专题页，必须检查上级入口、相关文章和转化入口是否完整。 ## 验证命令 - 修改链接后运行：npm run lint - 如果项目已有链接检查脚本，运行：npm run check:links - 如果修改 sitemap 或动态路由，运行构建命令并检查生成结果。 ## 禁止事项 - 不要把外链误判为站内链接。 - 不要把按钮全部改成普通文本链接。 - 不要为了修复内链改变页面视觉层级。 - 不要删除已有链接，除非确认它是死链、重复链接或无关链接。

第七步：用测试和脚本防止内链再次混乱

如果项目经常更新内容，单靠人工审查不够。建议让 Codex 生成一个简单的链接检查脚本，或者接入现有测试流程，在提交前检查内部链接是否有效。

请为当前项目设计一个站内链接检查脚本方案。 目标： 1. 扫描页面、导航配置、MDX/Markdown 内容中的站内链接 2. 检查链接目标是否存在 3. 检查是否存在 http 内链、重复尾斜杠、大小写不一致、旧路径 4. 输出孤岛页和死链报告 5. 支持在 CI 或本地 npm script 中运行 请先说明实现方案，不要直接写代码。 请列出： - 需要扫描哪些目录 - 如何识别动态路由 - 如何处理 CMS 或远程内容 - 报告格式 - npm script 命名建议 - 哪些问题应该让 CI 失败，哪些只作为 warning

对中小型网站来说，不一定要做复杂系统。能在每次构建前发现 404、旧路径、孤岛页和 sitemap 不一致，已经能解决大部分内链混乱问题。

可复制 Codex 指令合集

1. 站内链接总审计指令

请你作为 SEO 技术审计人员，检查当前项目的站内链接结构是否混乱。 请扫描路由、导航、页脚、面包屑、内容页、专题页、sitemap、redirects 和链接组件。 请输出： - 全站页面清单 - 页面之间的链接关系 - 孤岛页 - 死链 - 重复路径 - 旧路径 - 重要页面是否缺少入口 - 文章页是否缺少相关内链 - sitemap 与实际入口是否一致 - 修复优先级 不要修改代码，先输出审计报告。

2. 孤岛页专项检查指令

请找出当前项目中的孤岛页。 定义：页面存在于路由、页面文件、CMS 内容或 sitemap 中，但没有任何其他站内页面链接到它。 请输出： - 孤岛页路径 - 页面类型 - 是否在 sitemap 中 - 为什么没有入口 - 建议从哪些页面添加入口 - 推荐锚文本 - 涉及文件

3. 死链和旧路径检查指令

请检查当前项目所有站内链接是否存在死链、旧路径和跳转链。 请重点检查： - a 标签 href - Link 组件 href - 导航配置 - 页脚配置 - Markdown/MDX 链接 - sitemap 生成结果 - redirects 配置 请输出问题链接、来源文件、目标路径、问题原因和修复建议。

4. 文章内链优化指令

请检查所有文章页的内部链接质量。 不要只统计数量，请判断每个内链是否主题相关、锚文本是否清晰、是否能帮助用户进入下一步。 请为每篇文章建议： - 应该新增的上级专题链接 - 应该新增的相关文章链接 - 应该新增的服务页 / 产品页 / 转化页链接 - 应该删除或替换的无关链接 - 推荐锚文本

5. 修复后复查指令

请复查刚才的站内链接修改。 请确认： 1. 没有新增 404 链接 2. 没有引入重复路径 3. 没有破坏导航、页脚和面包屑 4. 核心页面入口更清晰 5. sitemap、页面路由和站内入口保持一致 6. 移动端导航没有遗漏核心页面 7. 修改没有改变页面视觉布局 请运行项目现有的 lint、typecheck、build 和链接检查脚本。如果没有链接检查脚本，请说明无法自动验证的部分。

人工验收清单

Codex 可以完成结构扫描和代码修改，但最终仍然需要人工验收。尤其是锚文本、专题关系和转化路径，不能完全交给自动判断。

常见错误

错误一：把内链优化理解成“到处加链接”

站内链接不是越多越好。无关链接会稀释页面主题，也会让用户不知道下一步该去哪。内链应该服务于用户路径和主题结构，而不是服务于链接数量。

错误二：只检查文章内链，不检查导航和页脚

文章内链很重要，但导航、页脚和面包屑更稳定。很多核心页面排名弱，不是文章没写够，而是全站入口太少。

错误三：只看页面是否能打开，不看路径是否统一

页面能打开不代表链接结构健康。同一个页面如果同时存在多个 URL，可能会分散权重。站内链接应该始终指向规范 URL。

错误四：修改内链时顺手改视觉

内链审计的目标是结构清晰，不是重新设计页面。除非确实需要新增模块，否则不应该因为修内链而改变视觉层级、按钮样式或页面布局。

错误五：没有把规则沉淀下来

一次性修复只能解决当前问题。真正有效的做法是把内链规则写进 AGENTS.md、检查脚本和发布流程里，避免后续新增页面继续制造混乱。

FAQ

1. Codex 能直接判断哪些内链最有 SEO 价值吗？

它可以根据页面结构、标题、路径和上下文给出建议，但不能替代关键词研究和业务判断。哪些页面应该重点推，需要结合搜索需求、转化价值和内容资产决定。

2. 网站页面少，也需要检查站内链接吗？

需要。页面少的时候更容易修清楚。尤其是企业官网、SaaS 官网和个人作品集，首页、服务页、案例页、关于页、联系页之间的路径如果不清晰，会直接影响咨询和转化。

3. Codex 能检查 CMS 里的文章内链吗？

如果文章内容在代码库里的 Markdown、MDX 或 JSON 中，Codex 可以直接检查。如果内容在远程 CMS，需要把导出的内容、接口结构或示例数据提供给 Codex，或者让它编写脚本通过接口检查。

4. 内链修复应该一次性全改吗？

不建议。先修 P0 和 P1，例如死链、孤岛页、重要页面无入口、sitemap 不一致。再处理文章内链、专题结构和锚文本优化。

5. 内链检查和 sitemap 检查有什么区别？

sitemap 告诉搜索引擎有哪些 URL；站内链接告诉搜索引擎这些 URL 在网站结构里是什么关系。页面出现在 sitemap 中，不代表它在站内有足够入口。

总结

用 Codex 检查站内链接是否混乱，核心不是让它随便加链接，而是让它把网站的链接网络梳理清楚：哪些页面存在、哪些页面重要、哪些页面没有入口、哪些链接指向错误、哪些路径重复、哪些内容没有形成主题关系。

比较稳妥的流程是：先生成全站链接地图，再检查导航、页脚和面包屑，然后检查文章和专题页，接着处理孤岛页、死链、重复入口和跳转链，最后把内链规则写入 AGENTS.md，并补充链接检查脚本。

对 SEO 来说，站内链接不是细节，而是网站结构的骨架。结构清晰，搜索引擎更容易理解页面关系，用户也更容易完成下一步动作。Codex 的作用，是把原本分散在代码、内容和配置里的链接问题系统化暴露出来，再辅助你按优先级修复。