Windows下hosts修改无效的主因是权限不足、编码错误、格式不规范或DNS缓存未刷新，需以管理员身份编辑、用ANSI/UTF-8编码、确保IP与域名间为英文空格或Tab、每行仅一个映射，并执行ipconfig /flushdns生效。
直接改 /etc/hosts 或 C:\Windows\System32\drivers\etc\hosts 能绕过 DNS 解析失败，但**90% 的人改完没用，是因为 hosts 本身没生效，不是 Composer 配置问题**。
hosts 文件格式和权限必须严格符合要求
写错一个空格或少一个权限，系统就当它不存在。常见错误包括：
- Windows 下没用“以管理员身份运行”记事本，保存静默失败（无提示）
- Linux/macOS 编辑
/etc/hosts没加sudo，文件实际没写入 - IP 和域名之间用了中文空格、冒号
:、等号=或全角符号，必须是英文空格或 Tab - 一行写了多个映射，比如
223.5.5.5 mirrors.aliyun.com repo.packagist.org—— 这完全无效，每行只能一个域名
IP 必须实时可用，且要验证是否真正生效
抄网上过期的 IP 是最常见坑。阿里云镜像 IP 经常变动，不能靠记忆或旧教程。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 获取最新 IP：
dig mirrors.aliyun.com @8.8.8.8 +short | head -n1（Linux/macOS）或nslookup mirrors.aliyun.com 8.8.8.8（Windows） - 写入 hosts 后，**必须刷新系统 DNS 缓存**：Windows 执行
ipconfig /flushdns（CMD/PowerShell 均需管理员权限）；macOS Ventura+ 需同时执行sudo dscacheutil -flushcache和sudo killall -HUP mDNSResponder - 验证是否生效：
nslookup mirrors.aliyun.com 127.0.0.1，返回的 IP 必须和 hosts 里写的一致；如果仍返回旧 IP 或超时，说明缓存没清或 hosts 格式错了
WSL2 用户必须在子系统内单独改 hosts
WSL2 的网络栈和 Windows 宿主机完全隔离，改 Windows 的 C:\Windows\System32\drivers\etc\hosts 对 WSL2 无效。
- 必须进入 WSL2 终端，用
sudo nano /etc/hosts编辑 - 同样要确保 IP 正确、格式规范、无多余字符
- 刷新 WSL2 内部 DNS 缓存：
sudo systemd-resolve --flush-caches（Ubuntu 22.04+ 默认启用）或sudo systemctl restart systemd-resolved
hosts 生效后还报 “Could not resolve host”？检查是否被重定向循环劫持
现象是 composer install 卡在 Downloading https://packagist.org/packages.json，日志反复出现 Redirecting to http://127.0.0.1:8080/... —— 这说明请求被本地代理或错误 hosts 条目劫持，形成 302 闭环。
- 运行
curl -v https://packagist.org/packages.json，看响应头里的location:是否指向本地地址 - 检查环境变量：
echo $HTTP_PROXY、echo $HTTPS_PROXY，若存在且指向本地调试代理（如 Charles、Fiddler），临时清掉：unset HTTP_PROXY HTTPS_PROXY - 检查 hosts 是否误加了
127.0.0.1 packagist.org这类条目，删掉它
真正卡点不在 Composer 本身，而在于操作系统 DNS 层与网络中间件的耦合——改 hosts 只是临时绕过，但一旦格式、权限、缓存、网络栈四者中任一环节出错，就等于白改。
