GoLand 无一键自动构建Web项目功能，需手动配置go.mod、设置go run main.go运行配置，并确保main包位置正确、模块初始化完整，否则将提示“no Go files”或无法运行。
GoLand 本身不提供“自动构建 Web 项目”的一键式功能，它只是智能地配合 Go 的模块系统和标准工具链工作。所谓“自动构建”，实际是正确配置 go.mod、启用 go run 或 go build 运行配置、并让 IDE 正确识别 main 包入口 —— 漏掉任一环，就会卡在“无法运行”或“no Go files in current directory”。
GoLand 创建项目时必须选对 Go module 初始化方式
新建项目时，如果直接点 New Project → Go 而没勾选 “Add Go module support”，GoLand 就不会自动生成 go.mod。没有 go.mod，go run main.go 在非 GOPATH 路径下会失败，IDE 也无法加载依赖或跳转符号。
- 务必在 New Project 对话框中勾选 Add Go module support（默认已勾选，但有人会手滑取消）
- Module path 建议填一个合法域名格式，比如
example.com/hello-web，避免用纯数字或下划线开头 - 如果项目已建好但漏了 module，别删重来：在项目根目录终端执行
go mod init example.com/hello-web，然后右键项目 →Reload project
GoLand 运行配置里要指定 go run main.go 而不是直接 run
GoLand 默认的运行配置（Run Configuration）类型是 Go Build，它会尝试编译成二进制，但 Web 服务通常需要热启调试 —— 直接用 go run main.go 更快，也支持 air 或 fresh 等热重载工具集成。
- 点击右上角运行配置下拉菜单 →
Edit Configurations…→ 左侧加号 →Go Tool Execution - Tool: 选
go；Arguments: 填run main.go；Working directory: 自动填项目根路径即可 - 不要用
Go Build类型配main.go，它会生成可执行文件但不自动运行，且不继承go run的模块环境变量 - 如果 main.go 不在项目根目录（比如放在
cmd/server/main.go），Arguments 改为run cmd/server/main.go
HTTP 服务启动失败？先检查这三个地方
go run main.go 启动后控制台没报错但浏览器打不开 localhost:8080，90% 是以下三个原因导致，和代码逻辑无关。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 端口被占：
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows），找到 PID 后kill -9 [PID]或任务管理器结束 - 模块未 tidy：
go mod tidy没执行，导致net/http等标准库引用异常（少见但存在，尤其跨 Go 版本迁移时） - 杀毒软件拦截：
Windows Defender或某些国产安全软件会静默阻止 Go 进程监听网络端口，临时关闭测试一下
GoLand 调试 Web 服务时 log.Fatal 会中断断点
用 log.Fatal(http.ListenAndServe(":8080", nil)) 启动服务很常见，但它会在出错时直接调用 os.Exit(1)，导致调试器无法捕获 panic 或继续执行 —— 断点全失效，错误堆栈也不完整。
- 改用显式 error 判断：
if err := http.ListenAndServe(":8080", nil); err != nil { log.Fatal(err) } - 或者更推荐：把
log.Fatal换成log.Println+return，让主函数自然退出，调试器全程可控 - 注意：GoLand 的 Debug 模式默认不捕获 os.Exit，即使加了断点，走到
log.Fatal就直接终止进程
真正麻烦的不是配置步骤多，而是 GoLand 对 “当前运行上下文” 的感知高度依赖 go.mod 和文件物理位置 —— 把 main.go 放错目录、go.mod 路径写错、甚至项目打开方式选成 “Open folder” 而非 “Open project”，都可能导致 run/debug 按钮灰掉或提示 no Go files。这些细节不报错，只静默失效。
