composer中文环境报错时，日志默认不自动落盘，需手动开启；持久化日志路径由composer_home决定（linux/macos为~/.composer，windows为%appdata%composer），但必须配合composer_log_level=4才能写入debug级日志，否则仅终端输出。
Composer 中文环境报错时，日志文件在哪？
Composer 默认不会生成详细日志，中文环境下遇到乱码、依赖解析失败或插件加载异常，composer install 或 composer update 往往只输出模糊提示（比如 Could not parse version constraint），根本看不出是编码问题还是配置错误。必须手动开启日志——它不存于 vendor/ 或项目根目录，而是由 COMPOSER_HOME 环境变量决定，默认路径是：~/.composer（Linux/macOS）或 %APPDATA%Composer（Windows）。但日志不是自动写入的，得加 -v 或 --debug 参数触发。
-
composer install -v输出到终端，不落盘；想保存，得重定向：composer install -v 2>&1 | tee install.log - 真正持久化日志要用
COMPOSER_LOG_LEVEL=4环境变量（4 表示 DEBUG 级别），再配合COMPOSER_HOME指向自定义目录，例如：COMPOSER_HOME=/tmp/composer-debug COMPOSER_LOG_LEVEL=4 composer update - 中文路径或包名出问题时，日志里会出现
mb_detect_encoding() returned false或json_decode(): UTF-8 error，这是关键线索，不是 Composer 本身 bug，而是 PHP 的 mbstring 扩展未启用或 locale 设置不匹配
中文路径导致 composer dump-autoload 失败怎么办？
composer dump-autoload 在含中文字符的文件路径下（比如 /Users/张三/project）容易崩溃，报错类似 file_put_contents(/Users/张三/project/vendor/autoload.php): failed to open stream。这不是权限问题，而是 Composer 内部调用 file_put_contents() 时未指定 UTF-8 编码上下文，而系统 locale（如 zh_CN.UTF-8）与 PHP 运行时的 default_charset 不一致所致。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时解决：在命令前强制设置 locale，例如 Linux/macOS 下运行：
LC_ALL=en_US.UTF-8 composer dump-autoload - 长期规避：避免在项目路径中使用中文，尤其不要放在用户主目录下（如
~/桌面）；改用英文路径，哪怕只是~/project-zh - 若必须支持中文路径，需确保 PHP 配置中
mbstring.func_overload关闭（已被废弃，但旧 ini 可能残留），且php.ini中default_charset = "UTF-8"
第三方中文包 require 失败，怎么从日志确认是镜像源问题？
国内用户常配置阿里云或腾讯云镜像源，但某些中文维护的私有包（如 my-company/wechat-sdk）未同步到镜像，composer require 会卡在 Loading from cache 后直接超时，终端只显示 Failed to download my-company/wechat-sdk。这时要查日志里的真实 HTTP 请求目标。
- 开调试模式运行：
COMPOSER_LOG_LEVEL=4 composer require my-company/wechat-sdk - 日志中搜索
Downloading或GET，看实际请求 URL 是https://mirrors.aliyun.com/composer/...还是https://packagist.org/... - 如果走的是镜像源但返回 404，说明该包未被镜像收录；此时可临时禁用镜像：
composer config -g repo.packagist composer https://packagist.org，再重试 - 注意：部分中文包的
composer.json中autoload字段用了中文路径（如"psr-4": {"My\WeChat\": "src/微信/"}），PHP 无法正确解析，日志里会暴露Class not found in .../微信/—— 这类问题和镜像无关，得改路径为英文
log 文件里出现 “Invalid argument supplied for foreach()” 怎么定位？
这个 Warning 常出现在自定义 Composer 插件或脚本中，比如在 post-install-cmd 里遍历 $event->getComposer()->getPackage()->getAutoload()，但中文包的 composer.json 里 autoload 字段为空或格式错误（如多了一个逗号导致 JSON 解析失败），就会让 PHP 返回 null 而非数组，进而触发 Warning。日志不会直接告诉你哪一行代码错了，只会记录堆栈顶层。
- 先确认是否是插件问题：运行
composer run-script --list查看所有注册脚本，再逐个禁用测试 - 检查
vendor/composer/installed.json是否可读，里面若存在中文键名（如"中文包名"）且 JSON 格式损坏，会导致整个 autoload 数据结构为空 - 最直接的办法是加一句调试输出：在出问题的脚本开头插入
file_put_contents('/tmp/debug.log', print_r($autoload, true), FILE_APPEND);，看实际拿到的是什么
fopen() 底层调用时如何被截断，或者 json_decode() 在不同 locale 下对 BOM 的容忍度差异。这些细节，光看 Composer 文档是找不到的。
