Fresh 项目中构建输出目录与静态资源目录的相对路径支持分析

在 Fresh 框架的配置中，开发者经常需要指定构建输出目录（build.outDir）和静态资源目录（staticDir）。当前版本中，这两个配置项对于相对路径的处理存在一些值得探讨的行为模式。

当前行为解析

Fresh 框架的配置对象接受 root 参数作为项目根目录，但有趣的是，当开发者尝试为 build.outDir 和 staticDir 指定相对路径时，这些路径并不会自动相对于 root 目录解析。例如：

export const app = new App<State>({
  root: './src',
  build: {
    outDir: './.fresh'  // 实际解析为项目根目录下的.fresh，而非/src/.fresh
  },
  staticDir: 'public'   // 同样解析为项目根目录下的public
});

这种处理方式与开发者直觉可能相悖，特别是考虑到当不指定这些目录时，它们的默认值确实会相对于 root 目录解析。这种不一致性可能导致配置上的困惑。

现有解决方案的局限性

目前开发者需要手动处理路径解析，这带来了两个主要问题：

1. 代码冗余：需要重复导入路径处理工具并拼接路径
2. 可读性降低：配置项变得冗长且不够直观

import { join } from '@std/path/join';

export const app = new App<State>({
  root: './src',
  build: {
    outDir: join(import.meta.dirname!, './.fresh')
  },
  staticDir: join(import.meta.dirname!, './public')
});

技术实现考量

从框架设计角度，支持相对路径解析需要考虑几个关键因素：

1. 路径解析的一致性：所有目录配置项应采用相同的解析策略
2. 向后兼容性：现有配置不应因修改而失效
3. 明确性：开发者应能清晰理解路径解析规则

理想情况下，所有路径配置项都应相对于 root 目录解析，这符合最小意外原则，也与大多数现代构建工具的行为一致。

改进建议方向

框架可以考虑以下改进方向：

1. 统一所有路径配置项的解析策略，均相对于 root 目录
2. 提供明确的文档说明路径解析规则
3. 考虑添加路径解析工具函数作为框架内置功能

这种改进将显著提升开发者体验，使配置更加直观和简洁，同时保持框架的灵活性和可配置性。