约束 AI 复用路由组件,避免站内跳转回退
文章建议将 AI 生成的站内原生链接纳入代码审查,要求复用项目已有的 Link 或 RouterLink。这样可保留客户端导航、预取及项目封装的路由行为,减少整页刷新造成的表单状态丢失。
AI 深度解读
AI 给页面加了一个「返回设置」,写成 <a href="/settings">,预览里能点,功能看似完成。但如果项目已经封装了 Link,这次修改可能绕过客户端路由,让页面整页刷新,丢掉尚未提交的表单内容。
作者给出的建议很具体:把站内裸链接当作合并前必须检查的问题。对使用 AI 改前端页面的团队,这篇文章的价值在于提醒我们:代码能运行,还不等于遵守项目已有的约定。
能跳到目标页,为什么还不能算完成
模型见过大量 HTML 示例,生成 `href="/settings"`` 很自然。问题是,地址正确只解决了「去哪」,没有解决「怎么过去」。
项目里的 Link、RouterLink 或 Next.js Link,可能承接客户端切换和预取;项目自己的封装还可能处理滚动恢复、语言前缀、base path、埋点,以及设计系统中的激活样式。裸 <a> 绕过这层入口,原文描述的后果包括整页刷新、草稿状态丢失,以及短暂出现未应用样式的状态。
这里要区分能力来源:这些行为不一定都是框架 Link 自带的,有些来自仓库里的共享封装。作者没有给出具体实现,也没有提供可复现的测试记录。
审查站内导航时,既要确认目标地址,也要确认它经过了项目规定的入口。
表单和多步向导尤其容易暴露问题。只做一次顺利的点击验收,可能发现不了刷新对中间状态的影响。
把导航边界写进提示词,别让模型重新发明组件
作者的导航规则并不复杂:站内路径使用已有 Link;外部 URL 使用 <a>,或项目已有的 ExternalLink,并沿用现有 rel 设置;mailto: 和文件下载可以保留锚点。哈希链接和页内跳转也要遵循现有模式,不要临时写一套 onClick。
下面这段提示词解决的是「模型知道要复用哪个入口,以及哪些链接属于例外」:
Internal routes must use the existing Link component (see src/components/Link or next/link).
Do not add a raw <a> for an in-app path.
External URLs, mailto, and file downloads may use <a>, with the existing rel/target helpers.
Do not invent a new NavLink or PrefetchLink.
要关注第一行给出的组件位置,以及最后一行禁止另造 NavLink、PrefetchLink 的约束。实际使用时,组件路径应与仓库一致。
「为了加预取」再造一个包装器,也可能制造第二套导航规则。作者还提醒检查 target:共享组件可能已经规定了新标签页行为,也可能明确禁止站内路由使用它。
代码审查要找绕过路由的入口
仓库如果已有 @next/next/no-html-link-for-pages 或自定义 ESLint 检查,作者建议把规则写进提示词。没有规则时,可以先用 <a href="/ 做一次简单文本搜索;审查 diff 时,再搜索更宽的 <a,逐个确认用途。
原文列出的典型退回项包括:
- 页面已经导入 Link,却新增
<a href="/dashboard">。 - 已有 Link,仍然新建 SmartLink。
- 站内链接强制设置
target="_blank"。 - 点击处理器通过
window.location.href =跳向站内路径。
判断标准是目标路径是否由应用路由管理。外部文档链接如果沿用了现有 rel,或者确实是共享 Link 不支持的下载链接,就有保留裸锚点的理由。
我的判断
我赞同作者把这件事纳入合并检查。共享导航组件往往承载了项目约定,AI 补一个看似独立的按钮时,很容易漏掉这些隐含要求。
但原文提供的是审查经验,没有对照数据,无法据此判断裸链接出现得多频繁,或增加提示词后能减少多少问题。整页刷新是否丢失草稿,也取决于状态是否持久化。
文本搜索适合作为低成本筛查,却不能证明导航没有问题。<a href="/ 会漏掉变量形式的地址,搜索 <a 也抓不到通过 window.location.href 实现的跳转。相比之下,ESLint 更适合持续约束已知写法,人工审查则负责判断下载、外链和特殊导航是否合理。
能拿来做什么
- 让 AI 修改导航前,先提供仓库实际使用的 Link 路径,并明确外链、下载和页内锚点的处理约定。
- 审查 AI 生成的 diff 时,检查新增
<a>、重复包装器和直接修改window.location.href的代码,确认站内跳转经过共享入口。 - 验收表单或多步流程时,带着未提交内容执行导航,再检查状态、滚动位置和语言路径是否符合项目预期。