配置分组名必须全小写加下划线，禁用大写字母和驼峰；错误命名将被框架静默忽略；推荐按“功能域+场景”清晰命名，如payment_alipay；多环境建议用env_dev等前缀明确标识。
配置分组名不能用大写字母或驼峰，必须全小写+下划线
ThinkPHP（5/6）所有配置项、包括分组名，都遵循统一的命名规范：小写字母 + 下划线。一旦混入大写字母（如 AdminGroup 或 APIConfig），框架在加载时会直接忽略该分组，且不报错——这是最常踩的静默坑。
正确示例：admin、api_v1、wechat_pay；错误示例：Admin、ApiV1、WECHAT_PAY。
- 分组名最终会参与文件路径拼接（如
application/extra/admin.php），而 Linux 系统对大小写敏感，Windows 下虽可能“碰巧”通过，但上线即崩 - 框架内部用
strtolower()统一处理分组键，大写字母会被强制转小写，导致你写的'APP_GROUP_LIST' => 'Home,Admin'实际只识别出home和admin - 模块级配置（如
application/admin/config.php）和分组配置（application/extra/admin.php）是两套机制，别把模块名误当分组名用
分组命名要体现作用域，避免泛义词如 common / base
用 common 作为分组名看似通用，实则埋雷：它无法区分是「全局通用配置」还是「某个业务线的通用配置」，后续多人协作时极易被覆盖或误删。
推荐按「功能域 + 场景」组合命名，例如：
立即学习“PHP免费学习笔记（深入）”；
-
payment_alipay（支付宝支付专用配置，含密钥、回调地址、沙箱开关） -
oss_qiniu（七牛云存储配置，含 bucket、region、token 超时） -
sms_yunpian（云片短信通道配置，含 apikey、签名、模板 ID）
这样命名后，config('payment_alipay.app_id') 语义清晰，IDE 也能正确提示补全，而不是靠猜 config('common.pay_appid') 到底指哪个。
多环境分组名建议加前缀，别依赖 app_status 动态切换
很多人想用 app_status 配合 office.php 这类状态配置来区分环境，但实际中容易失控：状态名本身没约束，开发、测试、预发、生产可能各自定义 dev/test/staging/prod，导致部署脚本要反复适配。
更稳妥的做法是把环境标识直接写进分组名里：
-
env_dev→ 对应application/extra/env_dev.php -
env_prod→ 对应application/extra/env_prod.php - 在入口文件或部署脚本里用
define('APP_ENV', 'prod')控制加载逻辑，而非靠框架自动匹配
这样既规避了 app_status 的隐式行为，又让配置文件物理隔离，CI/CD 打包时可精准剔除非目标环境配置。
分组名长度不是问题，歧义才是
有人担心 wechat_official_account_message_template 太长，其实 ThinkPHP 对分组名长度无限制，真正危险的是缩写或模糊词。
比如：wx_msg_tpl 容易被误解为「微信小程序模板」或「微信客服消息模板」；而 wechat_official_account_message_template 虽长，但一眼可知是公众号服务号的消息模板配置。
关键判断标准就一条：把这个分组名单独拎出来，不看上下文，团队新人能否 10 秒内说出它管什么？如果不能，就得重命名。
