Windows上用Docker开发Go项目可行，但需将项目置于WSL2 Linux文件系统（如/home/username/myapp）、禁用CGO、重置GOOS=linux、用air轮询监听并手动验证go mod download。
Windows 上用 Docker 开发 Go 项目完全可行，但默认的 WSL2 + Docker Desktop 组合下，go build 和 go run 在容器内执行时容易因路径、模块缓存、CGO 或文件监听问题失败——关键不在“能不能跑”，而在“怎么让 go mod 和 go build 在容器里像在宿主机一样可靠”。
确保 WSL2 后端与 Docker Desktop 正确协同
Docker Desktop 默认使用 WSL2 作为引擎，但 Go 开发中若直接在 Windows 文件系统（如 C:\dev\myapp）下挂载进容器，会触发 WSL2 的跨文件系统性能降级和 inode 不一致，导致 fsnotify 监听失效、go mod download 缓存校验出错。
- 把项目放在 WSL2 的 Linux 文件系统中（例如
/home/username/myapp），再从该路径启动 Docker：Docker Desktop 能原生访问 WSL2 文件，避免 Windows ↔ Linux 路径转换陷阱 - 检查
docker info | grep "Default Runtime"输出是否含runc；若为io.containerd.runhcs.v1（WSL1 兼容模式），需在 Docker Desktop 设置 → General → “Use the WSL 2 based engine” 打钩并重启 - 运行
docker run --rm -v $(pwd):/app -w /app golang:1.22-alpine go version测试基础挂载是否通——失败多半是路径没进 WSL2
Go 容器内构建必须绕过 CGO 和 Windows 路径残留
Windows 宿主机上 GOOS=windows 或 CGO_ENABLED=1 的环境变量若透传进 Linux 容器，会导致 go build 尝试链接 Windows 动态库或生成 PE 文件，直接报错 exec: "gcc": executable file not found in $PATH 或 cannot use windows resource file。
- 在
Dockerfile中显式重置关键变量：FROM golang:1.22-alpine ENV GOOS=linux ENV CGO_ENABLED=0 WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN go build -o myapp .
- 若需本地快速调试，用
docker run时强制覆盖：docker run --rm -v $(pwd):/app -w /app -e CGO_ENABLED=0 -e GOOS=linux golang:1.22-alpine go run main.go - 避免在
go.mod中写死// +build windows类条件编译标记，除非你真在容器里跑 Windows 子系统
热重载开发：用 air 替代 go run，但要禁用 Windows 特有监听机制
直接 go run 不支持文件变更自动重启；而 air 在 WSL2+Docker 下默认启用 inotify，但若项目目录挂载自 Windows NTFS，inotify 事件会丢失，air 就“卡住不动”。
立即学习“go语言免费学习笔记（深入）”；
- 安装
air到容器镜像：RUN go install github.com/cosmtrek/air@latest
- 创建
.air.toml并禁用 inotify，改用轮询：[watcher] delay = 1000 polling = true polling_interval = 500
- 启动命令改为：
docker run --rm -v $(pwd):/app -w /app -p 8080:8080 golang:1.22-alpine air -c .air.toml - 注意：轮询有 CPU 开销，仅用于开发；生产镜像务必删掉
air，用静态二进制直接ENTRYPOINT ["./myapp"]
最常被跳过的一步：每次改完 go.mod 后，别只 docker build，先在 WSL2 里手动跑一遍 go mod download -x 看真实依赖拉取路径和代理行为——Docker 构建时的模块缓存是隔离的，宿主机 go env GOPROXY 不会自动继承。
