ipv6优先导致局域网服务卡顿，因系统先试ipv6失败再回退ipv4产生延迟；可通过hosts绑定ipv4、禁用aaaa解析或调整gai.conf优先级解决。
这个问题核心在于 macos 默认优先尝试 ipv6 解析和连接，而局域网内很多 nas、本地开发服务（如 localhost:3000）、打印机或 smb 共享设备并不完整支持 ipv6，或其 ipv6 链路存在配置缺失、mtu 不匹配、防火墙拦截等情况。系统在 ipv6 连接失败后才回退到 ipv4，这个“试错延迟”会造成明显卡顿——比如 finder 挂载慢、safari 打开本地管理页要等几秒、curl 请求 hang 住。
确认是否是 IPv6 优先导致的问题
先验证现象：打开终端，执行
ping -c 3 localhost如果返回的是 ::1（而非 127.0.0.1），说明系统正优先走 IPv6 回环；再试
nslookup localhost看返回的 AAAA 记录是否被解析。接着访问你的局域网服务（如 http://nas.local 或 http://192.168.1.100:5000），对比用 http://127.0.0.1 和 http://localhost 的响应时间差异——若后者明显更慢，基本可锁定为 IPv6 优先策略干扰。
临时绕过：强制使用 IPv4 地址或 hosts 绑定
不改系统设置也能快速缓解，适合测试或短期使用：
- 所有调用中，把 localhost 替换为 127.0.0.1；把 nas.local 替换为它的 IPv4 地址（如 192.168.1.10）
- 编辑 /etc/hosts：用 sudo nano /etc/hosts，在末尾添加一行：
127.0.0.1 localhost（注意不要删掉原有 ::1 行，只确保 IPv4 行在前面） - 对 NAS 或其他设备域名，也加对应 IPv4 映射，例如：
192.168.1.10 nas.local
根本解决：禁用 IPv6 DNS 解析（推荐）
macOS 不会因关闭 IPv6 协议栈而影响基础功能，但直接关 IPv6 可能干扰某些现代服务（如 iCloud 同步、Continuity）。更稳妥的做法是让系统「不查 AAAA 记录」，即禁用 IPv6 域名解析，保留 IPv6 协议栈本身可用：
- 打开“系统设置”→“网络”，选中你正在用的有线/无线连接
- 点击右下角“详细信息…”→“DNS”标签页
- 在 DNS 服务器列表顶部，添加一个特殊地址：
127.0.0.1（前提是本机运行了支持禁用 AAAA 的 DNS 服务，如 AdGuard Home 或 dnsmasq） - 若未部署本地 DNS，可改用系统级屏蔽：终端执行
sudo sysctl -w net.inet6.ip6.disable=1
（重启失效，如需永久生效，写入 /etc/sysctl.conf）
进阶控制：调整协议优先级顺序
macOS 遵循 RFC 6724 的地址选择策略，可通过修改配置让 IPv4 地址优先于 IPv6：
- 终端运行：
sudo mkdir -p /etc/networks
echo "2002::/16 2" | sudo tee -a /etc/networks
（该规则将 6to4 隧道地址段降权，减少误选） - 更直接的方式是覆盖默认策略表：创建文件 /etc/gai.conf，填入
precedence ::ffff:0:0/96 100
这行确保所有 IPv4-mapped IPv6 地址（即 ::ffff:192.168.1.10 这类）获得最高优先级，实际效果等同于强制走 IPv4 路径
