Go环境不干净和go run报错“no required module”的根本原因是本地存在多版本Go残留及项目未执行go mod init初始化模块；需先清理旧版Go并重装，再在项目根目录运行go mod init example.com/myserver生成go.mod文件。
Go 环境装不干净、go version 显示旧版本、go run 报错找不到模块——这些问题基本都卡在环境清理和模块初始化两个环节。只要把这两步做对，后续写 Web 服务几乎就是复制粘贴几行代码的事。
怎么确认本地 Go 环境是干净的
很多人以为 brew install go 就完事了，结果 go version 还是显示 v1.16.7 或更老的版本。这是因为 macOS 上可能同时存在：
- 官网安装包写入的
/usr/local/go - Homebrew 安装的
/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel） - 手动加进
$PATH的旧路径（比如~/go/bin）
执行这三步就能快速定位：
which go → 看实际调用哪个二进制文件ls -la $(which go) → 看它指向哪go env GOROOT → 看运行时根目录是否匹配
立即学习“go语言免费学习笔记（深入）”；
如果发现多个路径，直接删掉旧的：sudo rm -rf /usr/local/go（官网安装残留）brew uninstall go（清 Homebrew 版）
再重装最新版，从 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载 pkg 安装包即可。
为什么 go run main.go 提示 “no required module”
这是 Go 1.11+ 默认启用模块（module）模式后的典型报错。不是代码问题，是项目没初始化模块。
解决方法只有一条命令：
go mod init example.com/myserver
注意：
- 模块名不用非得是真实域名，但不能是 main 或空字符串
- 执行后会生成 go.mod 文件，里面包含 module 行和 Go 版本声明
- 后续所有 import 的第三方包（比如 github.com/gin-gonic/gin）都会自动记录进 go.mod 和 go.sum
如果网络慢，记得提前配国内代理：go env -w GOPROXY=https://goproxy.cn,direct
用 net/http 快速起一个带超时的 Web 服务
标准库 net/http 足够跑生产级简单服务，但新手常漏设超时，导致连接堆积、内存泄漏。
关键点就三个：
-
http.Server必须显式设置ReadTimeout、WriteTimeout、IdleTimeout -
ListenAndServe不能直接调用，要配合signal.Notify实现优雅退出 - 路由注册别用
http.HandleFunc写死逻辑，先套一层http.NewServeMux()方便后续替换
最小可用示例：
package main
<p>import (
"context"
"fmt"
"log"
"net/http"
"os"
"os/signal"
"time"
)</p><p>func main() {
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "OK")
})</p><pre class="brush:php;toolbar:false;">srv := &http.Server{
Addr: ":8080",
Handler: mux,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 30 * time.Second,
}
go func() {
if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Fatal(err)
}
}()
quit := make(chan os.Signal, 1)
signal.Notify(quit, os.Interrupt)
<-quit
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatal(err)
}}
运行 go run main.go，Ctrl+C 能触发 Shutdown，而不是直接 kill 进程。
什么时候该换 Gin 或 Echo
纯 net/http 适合 API 网关、健康检查、转发代理这类逻辑极简的服务。但一旦出现这些需求，就该切框架：
- 需要中间件（日志、鉴权、CORS）
- 路由要支持路径参数（
/user/:id）或通配符 - 要绑定 JSON 请求体、校验字段、统一错误响应
- 要集成 Swagger、Prometheus、Zap 日志等生态工具
Gin 是最轻量的选择：go get -u github.com/gin-gonic/gin
然后把上面例子的 http.ServeMux 替换成 gin.Default()，其余逻辑几乎不用改。
真正容易被忽略的是：Gin 的 gin.Context 是请求生命周期绑定的，别把它传给 goroutine 做异步处理——它的底层 http.ResponseWriter 不是线程安全的。真要异步，得拷贝必要字段，或者用 channel 传递数据。
