hosts文件绑定失效主因是格式、权限或缓存任一出错，需确保管理员权限编辑、IP与域名间仅用英文空格分隔、刷新系统DNS缓存，并验证nslookup返回值与hosts一致。
hosts 文件写错导致 Composer 仍报 “Could not resolve host”
不是加了 IP 就生效，hosts 格式、权限、缓存三者任一出错都会让绑定失效。常见现象是 ping mirrors.aliyun.com 仍返回 Unknown host，或 composer install 日志里请求的仍是旧 IP。
- Windows 下必须用管理员权限打开记事本（右键 → “以管理员身份运行”），否则保存失败但无提示；Linux/macOS 编辑
/etc/hosts必须用sudo - IP 和域名之间只能用空格或 Tab 分隔，不能用中文标点、全角空格、冒号或等号
- 每行只写一个映射，不要合并多个域名到同一行，例如
223.5.5.5 mirrors.aliyun.com repo.packagist.org是无效的 - 确认 IP 是最新可用的：执行
dig mirrors.aliyun.com @8.8.8.8 +short | head -n1，别抄网上过期的 IP
改完 hosts 后 Composer 还不走新 IP？DNS 缓存没刷新
系统 DNS 缓存不刷新，curl 或 PHP 的 cURL 依然会查旧记录，导致请求发向被污染的地址。这不是 Composer 的 bug，而是操作系统级行为。
- Windows：运行
ipconfig /flushdns（CMD 或 PowerShell 均需管理员权限） - macOS：运行
sudo dscacheutil -flushcache；若用 macOS Ventura 及更新版本，还需补一句sudo killall -HUP mDNSResponder - Linux（systemd-resolved）：运行
sudo systemd-resolve --flush-caches；Ubuntu 22.04+ 默认启用，Debian 等可能需用sudo systemctl restart networking - 验证是否生效：执行
nslookup mirrors.aliyun.com 127.0.0.1，返回的 IP 应与 hosts 中一致
hosts 绑定后仍失败？镜像域名和实际请求 URL 不匹配
Composer 实际发起请求时拼接的路径，可能因配置错误指向不存在的 endpoint，导致 404 或 SSL 错误——此时 Could not resolve host 不再出现，但安装仍卡住。
- 阿里云镜像地址必须带末尾斜杠：
https://mirrors.aliyun.com/composer/，少/会变成/composerpackages.json，返回 404 - 华为云路径特殊：
https://mirrors.huaweicloud.com/repository/php/composer/，不是/composer/，也不是/php/composer/ - 腾讯云地址为
https://mirrors.cloud.tencent.com/composer/，注意二级域名是cloud.tencent.com，不是tencent.com - 绑定 hosts 时，只绑域名部分即可，如
223.5.5.5 mirrors.aliyun.com，不用写协议或路径
为什么 WSL2 下 hosts 修改无效？宿主机和子系统 DNS 独立
WSL2 使用虚拟网络，其 /etc/hosts 与 Windows 宿主机的 C:\Windows\System32\drivers\etc\hosts 完全隔离。你在 Windows 里改了 hosts，WSL2 里照样解析失败。
- WSL2 用户必须在 WSL2 内部编辑
/etc/hosts（用sudo nano /etc/hosts），而非改 Windows 的 hosts - Windows 用户若同时在 CMD、PowerShell、Git Bash、IDE 终端里跑 Composer，每个环境都可能读取不同 DNS 设置，需分别验证
- 某些 IDE（如 PHPStorm）内置终端默认继承系统代理或环境变量，即使 hosts 正确，也可能因
HTTP_PROXY干扰导致请求被转发到错误地址 - 验证方式：在 WSL2 终端里直接运行
curl -I https://mirrors.aliyun.com/composer/packages.json，看是否返回HTTP/2 200
真正起效的 hosts 绑定，是让系统跳过 DNS 查询直接命中 IP —— 但这个“直接”依赖格式正确、权限到位、缓存清空、路径匹配、环境隔离这五点全部对齐。漏掉任何一个，就只是看起来改了，实际上没走。
