如果你使用 GitHub Pages 或 Netlify,通常不会遇到这个问题。
问题出在 cleanUrl 功能上。如果你在 VitePress 的配置中启用了 cleanUrl(隐藏文件后缀名),默认情况下直接用 URL 访问会导致 404 错误。因为 Vercel 默认没有开启 cleanUrl 功能,而 GitHub Pages 和 Netlify 是默认开启的。
解决办法很简单,只需在项目根目录创建一个 vercel.json
文件,并设置 cleanUrl 功能为开启即可:
{
"cleanUrls": true
}
这样,Vercel 就会正确处理隐藏文件后缀名的 URL 访问了。