Composer 在中文路径下乱码或崩溃，根本原因是其默认按 UTF-8 解码 GBK 编码的包信息；Graphviz 可视化依赖图时节点重叠，因未设置 rankdir、nodesep 等布局参数；composer-unused 误报因无法检测动态类名、配置加载及反射调用；CI 编译失败常因残留 autoloader 映射或构建时依赖未被识别。
为什么 composer show --tree 在中文路径下会乱码或崩溃
根本原因是 Composer 默认使用系统 locale 编码解析包名和描述，而 Windows 中文版默认是 GBK，composer show --tree 内部调用的 Symfony Console 组件在输出含中文的包信息（如注释、作者名）时未做编码强制转换，直接按 UTF-8 解码字节流，导致 panic 或显示为 。
实操建议：
- 临时修复：终端启动前执行
chcp 65001（Windows），再运行composer show --tree - 长期方案：在项目根目录创建
COMPOSER_HOME/config.json，添加"process-timeout": 300并确保 PHP 启动时加载mbstring扩展（部分中文包依赖该扩展做字符串截断） - 绕过法：改用
composer show --format=json | jq '.'（需安装jq），JSON 输出天然 UTF-8 安全，再用 Python 脚本解析生成树状结构
用 graphviz 可视化 composer dependents 结果时节点重叠严重
Composer 原生命令不提供图谱导出，需手动提取依赖关系。直接把 composer dependents vendor/package 的扁平列表喂给 dot，会导致所有下游包作为一级子节点平铺，失去层级语义，Graphviz 自动布局时必然堆叠。
实操建议：
- 先用
composer show --tree vendor/package提取完整依赖链，再用 Python 脚本递归解析缩进层级，生成带 rank/same 属性的.dot文件 - 关键参数必须加：
rankdir=LR（横向布局更适合深依赖）、nodesep=20（节点最小间距）、concentrate=true（合并平行边） - 中文节点名务必包裹双引号并声明字体：
node [fontname="Microsoft YaHei", fontsize=10]，否则 Graphviz 用默认无衬线字体渲染中文会糊成一团
composer-unused 误报“未使用包”却漏掉真实冗余包
composer-unused 静态扫描 use 语句和函数调用，但对三类情况完全失效：动态类名（new $class）、配置驱动加载（如 Laravel 的 config/app.php 中注册的 service provider）、以及通过反射访问的类（如 Doctrine 的实体映射）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 运行前先执行
composer dump-autoload -o，避免因 autoloader 缓存导致类存在性判断错误 - 配合
phpstan分析：用phpstan analyse --level=0 --no-progress --error-format=raw src/ | grep "Class.*not found"反向定位被引用但未声明依赖的包 - 人工核验重点目录：
config/下所有 PHP 配置文件、database/migrations/中的 Schema 调用、tests/里 mock 的第三方类 —— 这些地方的依赖不会被composer-unused捕获
清理 vendor/ 后 CI 环境编译失败，提示 Class not found
问题不在 Composer 本身，而在于某些包（如 symfony/flex、laravel/pint）会在 post-autoload-dump 阶段向 vendor/composer/autoload_psr4.php 注入运行时逻辑，一旦你用脚本暴力删除了未被 composer-unused 标记但实际被构建工具调用的包，autoloader 就会残留无效映射，PHP 加载时找不到类却仍尝试 include。
实操建议：
- 永远不要手动删
vendor/子目录；清理后必须立刻执行composer dump-autoload -o强制重建映射表 - CI 脚本中加防护：在
composer install后插入校验步骤 ——php -r "include 'vendor/autoload.php'; echo class_exists('SomeUsedClass') ? 'OK' : 'FAIL';" - 对 Flex 类包，检查
composer.lock中是否残留其插件条目，若有，运行composer remove --dev symfony/flex彻底卸载而非仅删 vendor
真正麻烦的是那些只在构建时起作用、运行时不加载的包 —— 它们不会出现在任何 use 或 new 中，但删掉就会让 php artisan optimize:clear 或 npm run build 失败。这种得靠反复注释 require-dev 区块 + 观察 CI 日志来定位。
