#基础路径

基础路径（Base Path）是指应用程序中静态资源（如 JavaScript、CSS、图片等）的访问路径前缀。在 Esmx 中，合理配置基础路径对于以下场景至关重要：

• 多环境部署：支持开发环境、测试环境、生产环境等不同环境的资源访问。
• 多区域部署：适配不同地区或国家的集群部署需求。
• CDN 分发：实现静态资源的全球分发和加速。

#默认路径机制

Esmx 采用基于服务名的自动路径生成机制。默认情况下，框架会读取项目 package.json 中的 name 字段来生成静态资源的基础路径：/your-app-name/。

{
    "name": "your-app-name"
}

这种约定优于配置的设计具有以下优势：

• 一致性：确保所有静态资源使用统一的访问路径。
• 可预测性：通过 package.json 的 name 字段即可推断出资源的访问路径。
• 可维护性：无需额外配置，降低维护成本。

#动态路径配置

在实际项目中，我们经常需要将同一套代码部署到不同的环境或区域。Esmx 提供了动态基础路径的支持，使得应用程序能够适应不同的部署场景。

#使用场景

#二级目录部署

- example.com      -> 默认主站
- example.com/cn/  -> 中文站点
- example.com/en/  -> 英文站点

#独立域名部署

- example.com    -> 默认主站
- cn.example.com -> 中文站点
- en.example.com -> 英文站点

#配置方法

通过 esmx.render() 方法的 base 参数，你可以根据请求上下文动态设置基础路径：

const rc = await esmx.render({
    base: '/cn',
    params: {
        url: req.url
    }
});

#最佳实践

• 在生产环境中，建议通过环境变量或请求头来动态决定基础路径，避免硬编码。
• 使用 CDN 时，确保基础路径指向 CDN 域名，以充分利用缓存和加速能力。
• 多语言站点可以通过二级目录（如 /cn/、/en/）或独立域名来区分，根据业务需求选择合适的方案。