Skip to content

配置服务内部结构

想在 weapp-vite 中扩展配置加载或贡献新能力?这一页梳理了配置服务的核心文件,帮助你快速定位到对应模块。即便不准备修改源码,也能借此了解 defineConfig 背后的执行流程。

createConfigService.ts

  • 位置:packages/weapp-vite/src/runtime/config/createConfigService.ts
  • 负责初始化配置状态、导出 ConfigService 对外 API,并将内部工具组合在一起。
  • 统一维护 defineEnv、包管理器信息以及路径相关的辅助方法。

internal/alias.ts

  • 负责维护与注入内置别名,保证 @oxc-project/runtime 与内置依赖能被正确解析。
  • 提供 createAliasManager,供配置加载与合并阶段复用。

internal/loadConfig.ts

  • 专注从用户工程、weapp 配置文件与默认设置中生成最终的 InlineConfig
  • 同时处理增强迁移、rolldown 插件注入以及输出后缀推导等逻辑。

internal/merge.ts

  • 抽离运行时合并逻辑,包含 mergeWorkersmergemergeWebmergeInlineConfig
  • 对运行平台做统一的环境标记,并复用别名处理能力。

通过以上拆分,createConfigService.ts 体积控制在 300 行以内,同时文档化了各模块职责,方便在需要扩展配置时快速定位到对应实现。想进一步了解实际代码,可直接浏览仓库中的实现并结合调试能力(weapp.debug.inspect)验证行为。

Released under the MIT License.