根本原因是容器工作目录和宿主机代码路径未对齐，导致 go run 找不到 main.go 或 go.mod；需显式设置 -w /app、确保挂载路径为项目根目录、适配不同 shell 的路径写法，并注意 vendor、delve 调试配置、模块缓存挂载风险及日志/临时文件挂载陷阱。
挂载代码目录时为什么总报 no Go files in current directory
根本原因是容器工作目录和宿主机代码路径没对齐，go run 在当前路径下找不到 main.go 或 go.mod。
- 必须显式用
-w /app设置容器内工作目录，不能依赖镜像默认路径 -
-v $(pwd):/app要确保$(pwd)是项目根目录（含go.mod），不是子目录或空目录 - Windows PowerShell 用户得写成
-v ${PWD}:/app，CMD 或 Git Bash 下路径格式也不同，容易挂载失败 - 如果用了
go mod vendor，还得额外挂载./vendor:/app/vendor:ro，否则go run -mod=vendor会找不到包
Delve 调试连不上：端口、绑定地址、启动参数三处必查
VS Code 点调试按钮后提示 “Failed to launch: could not find Delve” 或连接超时，90% 出在这三个地方。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 容器必须暴露
2345:2345端口，且docker-compose.yml中ports字段不能缩写成2345 -
dlv启动命令里--addr必须是0.0.0.0:2345，写成127.0.0.1:2345就只能容器内访问 - VS Code 的
.devcontainer/devcontainer.json必须有"forwardPorts": [2345]，否则端口不自动转发 - 别在 Alpine 镜像里用
apk add dlv—— 装的是旧版，要统一用go install github.com/go-delve/delve/cmd/dlv@latest
模块缓存和 vendor 目录挂载的冲突点
挂载 ~/.cache/go-build 或 /go/pkg/mod 看似能加速构建，但实际容易引发 invalid module cache 或版本错乱。
- 不同 Go 版本的模块缓存不兼容，宿主机和容器 Go 版本稍有差异（比如 1.22.0 vs 1.22.3）就可能崩溃
- 挂载
/go/pkg/mod后，go mod download可能跳过校验，导致依赖被静默篡改 - 更稳妥的做法是：不挂载缓存，只挂载
./vendor并始终用go run -mod=vendor，彻底隔离容器环境 - 如果非要挂缓存，只挂
/go/pkg/mod，且确保宿主机和容器 Go 版本完全一致（包括 patch 版本）
日志和临时文件写入挂载卷的路径陷阱
Go 程序默认往容器可写层写日志或上传文件，重启后就丢失；但直接挂载到 /app 下又可能被源码覆盖。
- 代码里不要硬编码
/app/logs这类路径，应通过环境变量传入，比如LOG_DIR=/data/logs - Dockerfile 中提前
RUN mkdir -p /data，运行时用-v go-log:/data挂命名卷，比绑定挂载更安全 - 如果用绑定挂载，宿主机路径权限要匹配容器用户 UID（如
--user 1001:1001），否则os.OpenFile报 permission denied -
tmpfs适合放敏感临时数据（如 JWT 密钥解密中间态），但别用来存日志——内存满会导致 panic
os.MkdirAll 在容器首次启动时才执行，如果程序启动顺序依赖某个挂载路径已存在（比如 /data/cache），就得在 ENTRYPOINT 里先做初始化。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
