Composer 不支持中文翻译和运行时多语言切换，所有中文输出均来自框架（如 Laravel、Symfony）而非 Composer 本身；所谓“中文包”仅通过输出劫持实现且不稳定，官方不读取 locale 配置或环境变量，仅极少数帮助文本在特定条件下可翻译。
Composer 本身不提供中文翻译组件，也不支持运行时多语言自由切换——你看到的任何中文输出，要么是第三方包硬替换的副作用，要么是框架（如 Laravel、Symfony）自身能力，和 Composer 无关。
为什么 composer require 一个“中文包”不能让命令行变中文
常见误解是认为装个 csineneo/lang-simplified-chinese 就能全局汉化 Composer。实际它只是用 ob_start() + 正则劫持 stdout，稳定性差、不处理动态错误（比如 Git 克隆失败仍显示英文）、新版 Composer 一升级就失效。更关键的是：composer config --global locale zh_CN 写入的配置字段 Composer 主程序根本不读；LANG=zh_CN.UTF-8 环境变量对 Composer 命令文案也完全无效——它所有提示字符串都是硬编码英文。
真正生效的只有极少数帮助文本（如 composer --help 的选项说明），且需同时满足：系统已启用 zh_CN.UTF-8 locale、PHP intl 扩展开启、vendor/composer/lang/zh_CN/ 下有完整翻译文件（目前官方 2.7.x 版本中该目录多数为空）。缺一不可。
Laravel 项目里想加中文翻译，别碰 Composer 配置
Laravel 的多语言由框架自身驱动，Composer 只负责拉取静态资源。要加简体中文，正确路径是：
- 执行
composer require laravel-lang/lang --dev，安装后文件在vendor/laravel-lang/lang - 手动把
zh_CN子目录复制到resources/lang/zh_CN/（不能靠自动加载） - 确认分支匹配：Laravel 11 必须用
laravel-lang/lang的v11.x分支，否则validation.php键名结构错位 - 设置
config/app.php中的'locale' => 'zh_CN'和'fallback_locale' => 'en' - 清缓存：
php artisan config:clear && php artisan view:clear，否则旧翻译残留
Symfony 项目需要可切换的中文，得配 Translator + Loader
装 symfony/translation 只是第一步，它不会自动扫描 translations/ 目录：
- 必须显式注册 loader：
$loader = new YamlFileLoader(); $translator->addLoader('yaml', $loader); -
addResource()第四个参数（domain）必须和trans('welcome', [], 'messages')中第三个参数一致 - 路径要用绝对路径：
__DIR__.'/translations/messages.zh.yaml'，相对路径在 CLI/Web 下行为不一致 - 若用 YAML 格式，还得单独
composer require symfony/yaml（symfony/translation默认不带） - 切换语言不是改个配置就行，得调
$translator->setLocale('zh_CN')，且每次请求需重置
想在 Twig 模板里自由切语言？别依赖 gettext
Twig 原生 {% trans %} 默认绑死 PHP 的 gettext 扩展，但你可以换掉底层函数：
- 装
simplesamlphp/twig-configurable-i18n：composer require simplesamlphp/twig-configurable-i18n - 初始化时传入自定义翻译函数，比如用
__('hello', ['locale' => 'zh_CN'])调用你自己写的逻辑 - 这个包不修改模板语法，原有
{% trans %}标签继续可用，只是背后执行逻辑可编程 - 注意：它不解决翻译文件管理问题，只解耦了函数调用层——翻译数据来源（DB/JSON/API）仍需你自行实现
最常被忽略的一点：所谓“多语言自由切换”，从来不是 Composer 的职责。它不解析 locale、不加载 .mo、不提供运行时语言选择器。你真正要调试的，是框架的 Translator 实例生命周期、模板引擎的上下文注入方式、以及翻译资源的加载路径是否真实可达——而不是在 composer.json 里反复改 extra.language 或 config.locale。
