“connection refused”或“curl error 7”本质是系统级连通失败，非composer配置错误；需先验证dns（ping packagist.org）、端口与tls连通性（curl -i https://mirrors.aliyun.com/composer/packages.json），再排查防火墙、代理及证书问题。
报“Connection refused”或“cURL error 7”：先别动 composer config
这不是 Composer 配置错了，是系统根本连不出去。DNS 解析失败、防火墙拦截、代理干扰都会触发这类错误，改 repo.packagist 没用。
- 运行
ping packagist.org—— 如果返回unknown host，立刻换 DNS（比如nameserver 8.8.8.8写进/etc/resolv.conf） - 运行
curl -I https://mirrors.aliyun.com/composer/packages.json—— 若卡在* Connected to或* TLS handshake，说明连通性或 TLS 层有问题 - 企业环境常见陷阱：Zscaler/Netskope 类 HTTPS 解密代理会静默替换证书，此时需临时加
COMPOSER_DISABLE_TLS=1验证，但生产环境应配 CA 信任链 - macOS 用户特别注意：Homebrew 安装的 PHP 和系统 OpenSSL 路径常不一致，运行
php -r "print_r(openssl_get_cert_locations());"看default_cert_file是否可读
镜像配置写了却没生效：检查三个硬性条件
composer config -g repo.packagist 输出为空，不是“没生效”，是压根没写进去。Composer 2.x 会静默 fallback 到官方源，不报错也不提醒。
- 必须用单数
repo.packagist——repos.packagist或repositories.packagist.org全无效（后者仅 Composer 2.2+ 支持，且要配全路径） - 命令末尾必须带
composer类型值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意结尾斜杠） - 必须加
-g，否则只改当前项目composer.json，换目录就失效 - CI/CD 或宝塔常见坑：你用
root配了全局镜像，但实际运行的是www用户，得用sudo -u www composer config -g单独配
报“Permission denied”写 vendor/ 或 composer.lock
95% 不是权限不够，是目录“认错了主人”。vendor/、composer.lock 或 ~/.composer 被 sudo 污染过，属主是 root，而你正以普通用户运行命令。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查线索：报错里带路径的那一行就是关键，比如
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 问题在vendor/ - 查归属：
ls -ld vendor/ composer.lock ~/.composer—— 如果看到root root，立刻sudo chown -R $USER:$USER vendor/ composer.lock ~/.composer - 别用
chmod 777硬扛，这解决不了归属问题，反而埋下安全风险 - Windows WSL 用户注意：
/mnt/c/下的目录默认挂载为root，建议把项目放在~/下操作
报“Could not find package xxx”或“no matching package found”
不是包不存在，是 Composer 根本没查到它——要么拼写不对，要么源没配全，要么稳定性约束卡死了。
- 包名大小写、斜杠方向必须和 Packagist 页面完全一致：
laravel/sanctum≠laravel-sanctum≠Laravel/Sanctum - 私有 Git 包必须显式声明
"type": "vcs"，不能只写 URL；运行composer config repositories确认是否漏了 - 刚提交到 Packagist 的包可能有最多 1 分钟延迟，稍等再试
- 开发分支没打 tag、也没设
branch-alias，Composer 默认不认为它是可用版本；临时解法：composer require vendor/package:dev-main@dev - 运行
composer show -a | grep xxx或直接打开https://packagist.org/packages/vendor/package验证是否存在
真实请求地址永远藏在 composer install -vvv 的第一行 Downloading 日志里，而不是 composer config 的输出中。缓存、lock 文件、项目级 repositories 字段，三者任何一个残留都可能让镜像配置形同虚设。
