Configuration and Casing
大小写规则跟随 schema 边界。永远不要递归地转换一个配置对象。
| 边界 | 规则 | 示例 |
|---|---|---|
| 后端 facade 需求名 | 顶层 lower_case_with_underscore |
custom_css、css_variables |
| 注册表字段 | 每个字段遵循其文档化的注册表 schema | base_path、entry_point、tag_name |
| 由后端 YAML 携带的嵌套前端配置 | 保留小驼峰 | customCSS、themeConfig、iconifyIcons |
| 前端 AppConfig 与包元数据 | 小驼峰 | configOverrides、hostCssKeys |
config_overrides:
customization:
customCSS: ""
cssVariables: {}
routePrefix: /admin
proxy:
injections:
css:
themeConfig: true
customCss: true
iframe: true
在这个例子中只有后端包装键是蛇形命名。嵌套的前端对象被原样传递并保留其定义好的大小写。
临时的 mountRoute 例外
meta.mountRoute 是当前后端的一处兼容性缺陷。后端预期的字段是 meta.mount_route,但在后端修正发布之前,现有部署需要 mountRoute。请把它当作一个明确的例外,而不是注册表或后端字段普遍使用驼峰命名的证据。
合规检查必须为该例外标注版本,以便后端 schema 变更时可以移除它。