最常翻车的是模板中{{ .Site.BaseURL }}未被替换，导致浏览器静默丢弃base标签引发404；须确保base href值为合法路径且以/结尾，与前端路由base配置严格一致。
服务端模板里写 {{ .Site.BaseURL }} 但没替换就发到浏览器
这是最常翻车的点：模板里写了占位符，构建或渲染时没被真实路径替换，浏览器收到的是字面量 <base href="{{ .Site.BaseURL }}">。浏览器一看这不是合法 URL（既不以 /、http://、https:// 也不以 // 开头），直接静默丢弃整个 <base> 标签——后续所有 src="logo.png" 全按当前页面 URL 解析，上线即 404。
实操建议：
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 部署前用 curl 或浏览器开发者工具查看源码，确认
<base href="...>的值是真实路径，不是未解析的模板字符串 - Hugo 用户检查
config.toml中baseURL是否设对，且构建命令未禁用变量解析（如hugo --minify默认保留） - Jekyll 用户确认
_config.yml的url和baseurl组合后能生成合法根相对路径（如url: https://example.com+baseurl: "/blog"→href="/blog/"） - 若用 Node.js SSR（如 Express + EJS），确保
res.render()传入的base变量已拼好完整路径，且结尾带斜杠
<base href> 值结尾缺斜杠导致 Firefox 截断路径
写成 <base href="/myapp"> 看似没问题，但 Firefox 和 Opera 会把它截成 /myappcss/（把 css/ 直接粘到末尾），结果 <link href="css/app.css"> 变成请求 /myappcss/app.css，404。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 根相对路径必须以
/结尾：<base href="/myapp/"> - 绝对 URL 也建议结尾带斜杠：
<base href="https://cdn.example.com/v2/">，避免某些 CDN 对路径拼接异常 - 别依赖协议相对 URL（
//cdn...）来省事——如果页面本身是file://协议（本地双击打开），它会失效
SSR 模板拼接时 header 和 page 各 render 一个 <base>
常见于组件化 SSR 架构：Layout 组件里写了一个 <base>，某个子页面又动态插入一个。浏览器只认第一个，第二个被忽略；控制台可能报 Multiple base elements detected. Only the first one is used.，但你未必看到。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 把
<base>放到全局 Layout 的<head>最顶部，且禁止任何子组件、中间件、插件再尝试注入 - 用正则或 HTML parser 在构建后验证最终 HTML 中
<base出现次数是否为 1 - 如果必须动态决定路径（如多租户站点），改用构建时环境变量注入，而非运行时条件渲染
SPA 场景下 <base href> 和前端路由 base 配置不一致
HTML 里写了 <base href="/admin/">，但 Vue Router 的 createRouter({ base: '/admin/' }) 没配，或者配成了 '/dashboard/'。结果：静态资源（JS/CSS）能加载，但 router.push('/users') 跳到 /users 而非 /admin/users，路由匹配失败。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- HTML 的
<base href>和前端路由的base配置项必须完全一致，包括结尾斜杠 - Vue Router 用户检查
router.options.base是否生效；React Router v6+ 用户确认<Router basename="/admin/">包住了整个应用 - 避免在 HTML 中写
<base>却让路由库用默认base: '/'—— 这种割裂会让跳转和资源加载走两套逻辑，问题极难复现
build.base）和 HTML 的 <base href> 同时启用且值相同，资源路径就可能被拼两次，比如 /admin//admin/js/app.js。这种错误不会报错，只会静默 404。 
