端口被占用时，先用netstat或lsof命令查出占用进程的PID，确认后终止该进程或修改Go服务监听端口。可通过环境变量配置端口，避免硬编码，结合容器化部署提升灵活性，预防冲突。
Go 服务启动时提示端口被占用，基本就是有别的程序正在使用这个端口。解决方法很直接：要么让那个程序让出端口，要么给你的 Go 程序换个没被占用的端口。
确认是哪个进程占用了端口
第一步得搞清楚“元凶”是谁。在命令行里用下面这些命令查一下：
- Windows: 打开命令提示符或 PowerShell，运行 netstat -ano | findstr :端口号（把“端口号”换成你遇到问题的那个，比如8080）。输出结果里会有一串数字，那就是进程ID (PID)。然后运行 tasklist | findstr PID 就能知道是哪个程序了。
- macOS / Linux: 打开终端，运行 lsof -i :端口号 或者 netstat -tulnp | grep :端口号。命令返回的结果会直接显示占用端口的程序名和 PID。
知道了是哪个进程，就可以决定下一步了。
解决方案一：终止占用端口的进程
如果查到的进程是你不需要的、或者可以暂时关闭的（比如一个之前忘记关掉的旧服务实例），那就直接结束它。
- Windows: 在任务管理器里找到对应的 PID 或程序名，右键结束任务。或者在命令行用 taskkill /PID PID号 /F 强制结束。
- macOS / Linux: 在终端用 kill -9 PID号 杀掉进程。
之后再尝试启动你的 Go 服务，通常就能成功了。
解决方案二：修改 Go 服务的监听端口
如果那个占用端口的程序很重要不能关，或者你就是想避免冲突，最简单的办法就是让你的 Go 程序换一个端口。
这通常是在代码里设置的，找到类似 http.ListenAndServe(":8080", nil) 这样的代码行，把里面的端口号改掉，比如改成 ":8081" 或 ":3000"。
如果你的端口是通过配置文件（如 JSON、YAML）或环境变量读取的，就去修改相应的配置项。改完之后重新运行程序即可。
如何预防端口冲突
在开发时，端口冲突挺常见的，特别是跑多个微服务的时候。有几个小建议：
- 提前规划端口： 给项目里的不同服务约定好固定的端口范围，比如 API 服务用 8000-8099，前端用 3000，数据库用 5432/3306 等，大家遵守规则。
- 用环境变量： 不要把端口写死在代码里。用 os.Getenv("PORT") 从环境变量读取，这样部署时可以灵活指定，不容易撞车。
- 容器化部署： 用 Docker 的话，可以在 docker run -p 主机端口:容器端口 时指定不同的主机端口映射，彻底隔离。
基本上就这些，定位、解决、预防，三步搞定。
