macOS端口异常需分层清理：一、清空Wi-Fi首选列表与网络位置；二、重启mDNSResponder等守护进程；三、重置接口并刷新路由；四、删除SystemConfiguration下5个plist文件并重建数据库。
macos 本地网络端口状态本身不是独立“可重置”的对象，真正需要清理的是端口所依赖的底层网络栈、接口配置、服务绑定及缓存机制。所谓“开发端口异常”（如端口被占、bind失败、localhost不通、代理拦截、mdns解析错乱），根源几乎都来自网络配置残留、守护进程僵死或系统级缓存污染。彻底清理需分层操作，不能只 kill 进程或改端口号。
清空所有已知 Wi-Fi 与网络位置
图形界面删除 Wi-Fi 或忽略网络，常留隐藏偏好和位置模板，干扰本地服务监听（尤其 localhost 和 Bonjour）。终端才能扫净：
- 查看全部保存的 Wi-Fi 名称：
/usr/sbin/networksetup -listallpreferredwirelessnetworks Wi-Fi - 一键清空所有 Wi-Fi 配置：
sudo /usr/sbin/networksetup -removeallpreferredwirelessnetworks Wi-Fi - 列出所有网络位置：
networksetup -listlocations - 删除非默认位置（如 Home、Work）：
sudo networksetup -deletelocation "Home"（逐个执行） - 强制切回干净的 Automatic 位置：
sudo networksetup -switchtolocation "Automatic"
刷新 DNS、mDNS 与服务发现缓存
开发中 localhost 解析失败、AirDrop 异常、.local 域名不响应，多因 mDNSResponder 持有旧状态。dscacheutil 已弱化，关键在重载守护进程：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 重启 DNS 与 Bonjour 核心服务：
sudo killall -HUP mDNSResponder - 补发一次传统缓存清理（无害兼容）：
sudo dscacheutil -flushcache - 若隔空播放或 Handoff 不稳定，加一句：
sudo killall -HUP mDNSResponderHelper
重置物理/无线接口与路由表
接口处于 stale 状态（如 ARP 表错误、路由环路、socket 卡在 TIME_WAIT）会导致端口 bind 失败或连接超时。必须 down/up 接口并清内核网络层：
- 确认主接口名（通常 Wi-Fi 是 en0，M 系列部分为 en1）：
ifconfig | grep "^[a-z]" - 以 en0 为例，完整重载：
sudo ifconfig en0 down && sudo route -n flush && sudo ifconfig en0 up - Wi-Fi 用户额外启用硬件开关：
networksetup -setairportpower en0 on - 强制续租 DHCP（恢复正确网关/DNS）：
sudo ipconfig set en0 DHCP
重建 SystemConfiguration 底层配置库
/Library/Preferences/SystemConfiguration/ 下的 plist 是 macOS 网络行为的“唯一真相源”。它们损坏或残留会导致接口识别失败、DHCP 不触发、甚至 loopback（127.0.0.1）路由异常。这是最彻底的一步：
- 先停掉配置守护进程：
sudo launchctl unload /System/Library/LaunchDaemons/com.apple.networking.systemconfiguration.plist - 删除全部核心配置文件：
sudo rm /Library/Preferences/SystemConfiguration/{com.apple.airport.preferences,com.apple.network.identification,com.apple.wifi.message-tracer,NetworkInterfaces,preferences}.plist - 创建空白占位防止启动报错：
sudo touch /Library/Preferences/SystemConfiguration/preferences.plist - 重启守护进程：
sudo launchctl load /System/Library/LaunchDaemons/com.apple.networking.systemconfiguration.plist - 最后重启 Mac，系统将生成全新网络数据库，所有端口监听环境回归出厂级干净状态
