改DNS对境外扩展下载有效，因ISP DNS易被污染导致GitHub解析失败；换用8.8.8.8可提升解析成功率，但须同步配置国内镜像源（如阿里云），并验证composer config -g repo.packagist输出为完整JSON对象，再通过-vvv日志确认packages.json、API及git克隆三阶段均正常。
为什么改DNS对境外扩展下载有实际作用
Composer 安装境外包（比如 laravel/sail、spatie/laravel-ray）卡在 Downloading https://github.com/... 或 Cloning into '...'...，常不是因为 GitHub 本身慢，而是 DNS 解析失败或返回错误 IP——尤其当系统用 ISP 提供的 DNS 时，容易被污染或劫持。谷歌 DNS（8.8.8.8、8.8.4.4）响应稳定、无劫持，能显著提升域名解析成功率和首字节时间。
如何在不同环境安全启用谷歌 DNS
直接改系统 /etc/resolv.conf 可能被 systemd-resolved 或 DHCP 覆盖，推荐按场景选择：
- Linux/macOS 虚拟机或容器：运行
sudo systemctl disable --now systemd-resolved，再写入nameserver 8.8.8.8到/etc/resolv.conf（确保只保留一行nameserver） - Docker 容器启动时指定：
docker run --dns 8.8.8.8 --dns 8.8.4.4 php:8.3-cli composer require spatie/laravel-ray - CI 环境（如 GitHub Actions）：在
steps中加run: echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf（需permissions: contents: read） - Windows WSL2：编辑
/etc/wsl.conf加[network] generateResolvConf = false，再手动覆盖/etc/resolv.conf
仅换 DNS 不够，必须同步配镜像源
谷歌 DNS 解决了 github.com、api.github.com 解析问题，但 Composer 主流程仍依赖 packagist.org 的元数据。若没配国内镜像，packages.json 下载仍可能超时或失败。
执行这条命令确认生效：
composer config -g repo.packagist
输出必须是完整 JSON 对象，例如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果只显示 URL 字符串、空值或报错，说明配置失败——常见原因是键名写成 repos.packagist（多了一个 s）、URL 缺尾部 /、或 type 值漏写。
验证是否真正走通境外扩展链路
用 -vvv 日志观察三处关键节点：
- 看
Reading composer.json后是否立即出现Downloading https://mirrors.aliyun.com/composer/packages.json（确认镜像源生效） - 看
Downloading https://api.github.com/...是否快速返回 200（确认 DNS 解析 + TLS 握手正常） - 看
Cloning https://github.com/spatie/laravel-ray.git是否不再卡在remote: Enumerating objects（确认 git 协议层连通）
若前两步正常，第三步仍卡住，大概率是公司防火墙拦截了 git 协议（git:// 或 SSH），此时应强制走 HTTPS：git config --global url."https://".insteadOf git://。
