VitePress站点地图配置中base路径的正确使用方式

在使用VitePress构建文档网站时，站点地图(sitemap)的生成是一个重要功能，它能帮助搜索引擎更好地索引网站内容。然而，当项目配置了base路径时，开发者可能会遇到站点地图URL不完整的问题。

问题现象

当在VitePress配置中同时设置base路径和sitemap的hostname时，生成的站点地图URL会缺少base路径部分。例如：

export default defineConfig({
    base: '/path/',
    sitemap: {
        hostname: 'https://example.org'
    }
})

开发者期望生成的URL格式为https://example.org/path/...，但实际输出却缺少了/path/部分。

解决方案

正确的做法是在hostname中显式包含base路径，并确保以斜杠结尾：

export default defineConfig({
    base: '/path/',
    sitemap: {
        hostname: 'https://example.org/path/'
    }
})

技术背景

VitePress的设计哲学是保持配置的明确性和一致性。自动拼接base路径到hostname会导致以下问题：

1. 破坏现有项目的向后兼容性
2. 增加配置的隐式行为，降低可预测性
3. 无法处理更复杂的URL拼接场景

最佳实践建议

1. 始终在hostname中包含完整的base路径
2. 确保hostname以斜杠结尾，避免路径拼接问题
3. 对于多环境部署，考虑使用环境变量动态设置hostname

export default defineConfig({
    base: '/path/',
    sitemap: {
        hostname: process.env.SITE_URL + '/path/'
    }
})

通过遵循这些实践，可以确保生成的站点地图包含完整的URL路径，有利于SEO和用户体验。