执行docker-compose up提示stat main.go: no such file or directory错误求助

常见问题原因（结合你的场景） #

1. 路径分隔符不兼容 #

Mac/Linux系统默认用正斜杠/，Windows用反斜杠\，如果课程里的docker-compose.yml或Dockerfile沿用了Mac风格路径，Windows下Docker解析时会出现路径识别错误，比如卷挂载、文件复制指令失效。

2. Go模块未正确初始化 #

Go 1.16+默认启用Go Modules机制，过时课程可能未提及go mod相关操作，或者模块名称与容器内的代码导入路径不匹配，导致编译阶段报错。

3. Windows文件系统挂载权限/兼容性问题 #

Docker for Windows挂载本地目录到容器时，可能出现权限不足、文件锁定（Windows独占文件）或换行符格式不兼容的问题，导致容器无法读取本地代码。

4. Dockerfile编译指令不适配跨平台场景 #

课程里的Dockerfile可能用了Linux特有的编译命令，或者未设置Go跨平台编译参数（比如在Windows上构建Linux容器时，需要指定编译目标系统）。

新手友好的解决步骤 #

步骤1：统一路径格式 #

打开docker-compose.yml和Dockerfile，把所有路径的反斜杠\替换为正斜杠/：

• 示例docker-compose.yml卷挂载修正：

  volumes:
    - ./app:/go/src/app  # 用./app而非.\app或C:\xxx格式
  

• 示例Dockerfile复制指令修正：

  COPY ./main.go /go/src/app/
  

步骤2：初始化Go模块 #

在项目根目录打开PowerShell，执行以下命令：

# 初始化模块，替换为你的项目名称（比如github.com/yourname/yourproject）
go mod init your-module-name
# 拉取依赖并生成go.sum
go mod tidy

将生成的go.mod和go.sum放在项目根目录，确保Dockerfile能复制这两个文件用于编译。

步骤3：优化Docker挂载配置 #

• 优先使用WSL 2后端：打开Docker设置→Resources→WSL Integration，开启对应WSL发行版的集成（比Hyper-V后端路径兼容性更好）。
• 临时解决权限问题：在docker-compose.yml的服务配置中添加用户权限（新手可先用root测试，后续再调整为非root用户）：

  services:
    go-app:
      user: "root:root"
  

步骤4：修正Dockerfile编译逻辑 #

使用多阶段构建适配跨平台编译，示例Dockerfile：

# 构建阶段：用官方Go 1.19镜像
FROM golang:1.19-alpine AS builder
WORKDIR /go/src/app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
# 编译为Linux可执行文件（容器默认是Linux环境）
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app .

# 运行阶段：用轻量alpine镜像
FROM alpine:latest
WORKDIR /app
COPY --from=builder /go/src/app/app .
CMD ["./app"]

步骤5：先验证本地运行 #

先在Windows本地执行go run main.go，确保代码本身能正常运行，排除代码逻辑问题后再尝试docker-compose up。

内容的提问来源于stack exchange，提问作者wildcat89