VS Code开发容器内无法检测到Git问题排查求助

问题现象 #

在Visual Studio Code中打开Dev Container时，环境无法检测到Git，提前通过SSH密钥从GitHub克隆的项目在容器内提示不存在git repository，无法提交代码变更；Docker Desktop运行正常，项目build、clean、test等操作均可正常执行。
相关参考截图：

• DevContainer内Git检测异常截图：
  
• 本地存储克隆文件的文件系统截图：
  

分步排查解决 #

1. 先确认容器内是否安装了Git #

Dev Container是独立隔离环境，不会自动继承本地主机安装的软件，很多精简基础镜像默认不带Git。

• 连接到Dev Container后打开VS Code集成终端，执行命令：

  git --version
  

• 如果返回command not found: git，直接修改项目下的.devcontainer/Dockerfile，添加对应基础镜像的Git安装命令：
  • Debian/Ubuntu系基础镜像添加：

    RUN apt-get update && apt-get install -y --no-install-recommends git
    

  • Alpine系基础镜像添加：

    RUN apk add --no-cache git
    

• 修改完成后按Ctrl+Shift+P打开命令面板，执行Dev Containers: Rebuild Container重建容器即可。

2. 确认.git目录被正确挂载到容器内 #

Git识别仓库全靠根目录下的隐藏.git文件夹，这个目录没挂载进容器的话，就算装了Git也会提示不是仓库。

• 在容器内的项目根目录终端执行：

  ls -a
  

• 如果返回的文件列表里没有.git文件夹，先排查两个配置：
  • 打开项目根目录的.dockerignore文件，删除所有匹配.git的忽略规则，避免构建/挂载时把.git目录排除
  • 打开.devcontainer/devcontainer.json，确认工作区挂载配置正确，参考配置如下：

    "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces/你的项目名,type=bind,consistency=cached",
    "workspaceFolder": "/workspaces/你的项目名"
    

• 调整完成后重建容器，再执行ls -a确认.git目录存在。

3. 配置SSH密钥转发解决提交权限问题 #

就算能识别到仓库，容器默认也拿不到本地的SSH密钥，提交/拉取代码时会报权限错误。

• 先在本地主机终端（不是容器内终端）执行命令，确认SSH agent正在运行且已经添加了GitHub私钥：

  ssh-add -l
  

  如果提示没有可用身份，执行ssh-add ~/.ssh/你本地存的GitHub私钥文件名（默认一般是id_ed25519或者id_rsa）添加密钥。
• 打开.devcontainer/devcontainer.json，添加配置开启SSH agent转发：

  "forwardAgent": true
  

• 重建容器后，在容器终端执行ssh -T git@github.com验证，返回对应GitHub账号欢迎信息就说明配置正常。

验证方式 #

所有配置改完重建容器后，在容器终端执行git status，能正常列出当前代码变更就说明配置生效，VS Code左侧源代码管理面板也会自动识别仓库状态。

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