基础路径#

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

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

默认路径机制#

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

1{
2    "name": "your-app-name"
3}

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

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

动态路径配置#

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

使用场景#

二级目录部署#

独立域名部署#

配置方法#

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

1const render = await esmx.render({
2    base: '/cn',  // 设置基础路径
3    params: {
4        url: req.url
5    }
6});