端口被占需区分普通进程与系统服务：用lsof -itcp -stcp:listen -n -p | grep :端口号识别，若command为controlcenter等或pid
遇到“端口已被占用”错误，核心不是换端口或重启软件，而是分清两类情况：一类是普通开发进程（如 node、python）意外残留；另一类是系统级服务（如 macos 的 airplay receiver、control center 服务、或某些后台 daemon）占用了 80、443、5000、7000 等常见端口。后者不能随便 kill，需针对性处理。
先确认是不是系统服务在占端口
执行命令时加 -sTCP:LISTEN 和 -n 参数，过滤出真正监听的进程：
- lsof -iTCP -sTCP:LISTEN -n -P | grep :80（把 80 换成你实际报错的端口号）
- 若输出中 COMMAND 列显示 ControlCenter、AirPlayXPCHelper、sharingd、rapportd 或 distnoted，基本就是系统服务
- 特别注意：PID 很小（比如 1–200）或 USER 是 root 或 _windowserver 的，大概率是系统进程
系统服务占端口，别硬杀，优先换端口
系统服务通常无法安全终止，强行 kill 可能导致 AirDrop 失效、屏幕镜像中断、通知中心异常等。稳妥做法是绕开它：
- 前端项目（Vite/React/Vue CLI）：启动前加环境变量 PORT=3001 npm run dev 或 yarn dev --port 3001
- Express/Koa 服务：代码里改 app.listen(process.env.PORT || 3000)，再用 PORT=4000 node server.js
- VS Code Live Server 插件：设置里搜 liveServer.settings.port，填个非冲突值（如 5502）
- 调试配置（launch.json）：把 "port": 9229 改为 9231 等高位端口
个别可安全停用的系统服务（仅限开发机）
以下服务若确认没在用，可通过终端临时禁用，释放端口：
- AirPlay 接收：关闭「系统设置 → 通用 → 隔空播放与接力」中的「允许隔空播放」
- 控制中心共享：运行 sudo launchctl unload -w /System/Library/LaunchDaemons/com.apple.AirPlayXPCHelper.plist（重启后恢复）
- Handoff/Continuity：运行 sudo defaults write /Library/Preferences/com.apple.NetworkBrowser DisableAirDrop -bool YES，再重启 mDNSResponder
预防下次再撞上
长期开发建议建立端口使用习惯：
- 开发端口尽量避开 1–1024（需 root）、以及 5000/7000/8000/8080 这些 macOS 默认服务高频区
- 团队协作时，在 README.md 里注明推荐端口，并统一用 process.env.PORT 读取
- 写个简易脚本检查常用端口：for p in 3000 5000 8000; do echo "$p: $(lsof -iTCP -sTCP:LISTEN -n -P | grep :$p | head -1)"; done
