报错“Your requirements could not be resolved”是依赖版本冲突，非网络问题；需提供composer why-not输出、php -v、composer install -vvv前20行及composer.json中require片段。
报错信息里带 “Your requirements could not be resolved” 怎么问？
这不是网络问题，是依赖约束打架了。提问时别只贴整段红字，要提取关键冲突点：composer why-not php:8.3 的输出必须带上——它会直接告诉你哪个包卡着升级，比如 laravel/framework v10.42.0 requires php ^8.1，但你项目里还有个 old-bundle 锁死 php: ^7.4。
同时附上三行最小上下文：
-
php -v输出（确认 CLI 真实版本） -
composer install -vvv 2>&1 | head -n 20截取前 20 行（找 “Problem 1” 开头那块） -
cat composer.json | grep -A2 "require"（看 PHP 和关键包的声明）
卡在 “Loading composer repositories” 或超时怎么问？
国内用户八成是镜像或证书问题，不是你本地坏了。提问前先做两件事：
- 运行
composer config -g repo.packagist，把返回的源地址贴出来（如果是https://packagist.org，就说明没切镜像） - 执行
composer clear-cache && composer install -vvv，复制从 “[debug] Executing command” 开始的前 15 行日志（里面会有 DNS 解析失败、TLS handshake timeout 等真实线索）
如果用公司代理或内网环境，顺手加一句“已配 http-proxy”，否则别人会默认你直连。
Permission denied: failed to create directory vendor/ 怎么问？
90% 是 sudo composer install 后遗症。提问时别只说“没权限”，要给出归属信息：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
ls -ld vendor/（看属主是不是root） -
ls -ld $(composer config -g home)（检查全局缓存目录归属） - 是否在 WSL 下、项目路径是不是
/mnt/c/xxx（NTFS 权限不生效，得换路径）
如果已经 sudo rm -rf vendor/ 过，也请注明——这会影响后续修复建议。
Could not find package xxx 怎么问？
包名大小写、镜像同步延迟、拼写错误都可能导致这个报错。提问时必须核对并说明：
-
composer search xxx是否能搜到（确认包名没写错，比如monolog不是monolong） -
composer show xxx是否返回 “No package found”（排除私有仓库未配置） - 你用的是不是阿里云镜像？刚发布的包可能还没同步，可临时切回官方源试：
composer config --global repo.packagist composer https://packagist.org
别只贴 “Could not find package laravel/sanctum”，得让别人知道你是输错、还是镜像没更新、还是根本没注册到 Packagist。
真正难复现的问题，往往藏在 PHP CLI 和 Web 模块用不同 php.ini 这种细节里。提问时少说“我重装了 Composer”，多给 php --ini 和 php -m 的实际输出——线索都在那儿，不在你的猜测里。
