RFC-015: YaoXiang 配置系统设计 — 审核完成与实现

[ChenXu233]

RFC-015: YaoXiang 配置系统设计

状态: 已接受 — 待实现

摘要

设计 YaoXiang 语言的统一配置系统，支持用户级和项目级两个层级，为包管理器、编译器、REPL、LSP 等组件提供共享的配置基础设施。

文档

• RFC 原文

实现清单

• 用户级配置 (): i18n/repl/fmt/lint/install
• 项目级配置 (): fmt/runtime (基础)
• 配置层级合并（用户级 + 项目级 + 默认值合并逻辑）
• CLI 参数/环境变量覆盖
• yaoxiang config init/edit/show/reset 命令
• 项目级配置完整化（package/dependencies/bin/lib/build/profile/repl/lint/test/tasks/i18n）
• --config- CLI 参数覆盖
• 环境变量覆盖 (YAOXIANG_*)
• 单元测试覆盖
• 集成测试覆盖

当前实现进度

核心配置数据结构已实现，merge 逻辑和 CLI 命令尚未完成。详见 src/util/config/mod.rs。

[ChenXu233]

代码实现分析

已实现部分 (约 35%)

用户级配置 ():

• ✅ UserConfig 结构体: i18n/repl/fmt/lint/install
• ✅ I18nConfig: lang/fallback/error_lang/local_lang
• ✅ ReplConfig: history_size/history_file/prompt/colors/auto_imports
• ✅ FmtConfig: line_width/indent_width/use_tabs/single_quote/sort_imports
• ✅ LintConfig: rules/strict/dead_code + WarningLevel enum
• ✅ InstallConfig: dir (Option)
• ✅ load_user_config(), load_or_create_user_config(), save_user_config()
• ✅ get_config_dir(): XDG_CONFIG_HOME → ~/.config → %APPDATA%
• ✅ get_config_path(), config_exists()
• ✅ ConfigError 错误类型

项目级配置 (基础):

• ✅ ProjectConfig: 包含 fmt/runtime 两个字段（仅部分实现）
• ✅ RuntimeConfig: mode/workers

消费方集成:

• ✅ FmtConfig → FormatOptions 转换 (src/formatter/options.rs)
• ✅ load_user_config().i18n 在 REPL/LSP 中使用 (src/util/i18n/mod.rs)
• ✅ UserConfig → I18nConfig 导出别名
• ✅ ProjectConfig 在 main.rs 中被解析

未实现部分 (约 65%)

核心缺失:

• ❌ 用户级 + 项目级配置的 merge 逻辑（RFC 定义的标量替换/数组替换/对象深度合并）
• ❌ 配置优先级链: 命令行 > 环境变量 > 配置文件 > 默认值
• ❌ yaoxiang config 子命令系列 (init/edit/show/reset)

项目级配置缺失字段（RFC 设计的完整 ProjectConfig）:

• ❌ [package]: name/version/description/authors/license/repository
• ❌ [yaoxiang]: version 约束
• ❌ [dependencies] / [dev-dependencies]
• ❌ [[bin]] / [lib]
• ❌ [build]: script/output
• ❌ [profile.*]: optimize/lto
• ❌ [repl] 在项目级
• ❌ [lint] 在项目级
• ❌ [test] 在项目级
• ❌ [tasks] 在项目级
• ❌ [i18n] 在项目级

用户级配置缺失字段:

• ❌ [build]: output（RFC 标注两者皆可）

CLI/环境变量覆盖:

• ❌ 命令行 --config-* 参数
• ❌ 环境变量 YAOXIANG_* 解析
• ❌ 三层次优先级合并引擎

测试覆盖:

• ❌ config 模块单元测试
• ❌ merge 语义测试
• ❌ 环境变量/CLI 覆盖测试

总结

模块	状态	备注
Config 数据结构	✅ 35%	基础字段集完成
Merge/优先级	❌	核心逻辑未实现
CLI 命令	❌	yaoxiang config 系列
项目配置完整	❌	仅 fmt/runtime
环境变量	❌	未实现
测试	❌	无