VSCode不直接连接GitLab，而是调用本地git命令；需确保远程URL为SSH格式（git@host:group/project.git）或带oauth2前缀的HTTPS PAT URL，同时验证SSH密钥信任、自签名证书导入系统根证书库、.git所在目录为工作区根路径。
VSCode 本身不“连接” GitLab，它只调用本地 git 命令操作仓库；所谓“连上本地 GitLab”，本质是让 git 能通过 SSH 或带 PAT 的 HTTPS 正确访问你公司内网或自建的 GitLab 实例。绝大多数失败不是 VSCode 的锅，而是远程 URL 格式、密钥信任、证书或权限没对。
检查 git remote URL 是不是 SSH 格式（git@host:group/project.git）
VSCode 的源代码管理面板完全依赖 .git/config 里的 url 字段。HTTPS 地址即使能 clone，也大概率在 push 时卡住或报 remote: HTTP Basic: Access denied——因为企业 GitLab 几乎都禁用了密码登录。
- 在项目根目录终端运行：
git remote get-url origin - 如果输出是
https://gitlab.internal/group/project.git，立刻改掉：git remote set-url origin git@gitlab.internal:group/project.git - 注意：必须用冒号
:分隔主机和路径，不能写成ssh://git@gitlab.internal/group/project.git——VSCode 内置 Git 对这种格式支持不稳定 - 改完后，在 VSCode 里点「拉取」或看底部状态栏，确认显示的是
origin而非报错
验证 SSH 是否通（ssh -T git@gitlab.internal）
VSCode 不管密钥，只调用系统 git，而 git 走的是 ssh。所以先抛开 VSCode，终端里跑通才是关键。
- 执行：
ssh -T git@gitlab.internal（把gitlab.internal换成你实际的域名） - 期望输出：
Welcome to GitLab, @username!；如果报Permission denied (publickey)，说明密钥根本没被 GitLab 信任 - 检查公钥是否已粘贴到 GitLab 的
Settings → SSH Keys页面（内容要完整，含ssh-ed25519或ssh-rsa开头整行） - 确认私钥已加载：
ssh-add -l应列出你的密钥；没列？运行eval "$(ssh-agent -s)" && ssh-add ~/.ssh/id_ed25519
自签名证书导致 HTTPS 克隆失败（SSL certificate problem）
如果你非得用 HTTPS（比如公司防火墙封了 22 端口），又用的是自签证书，git clone https:// 会直接报错。别碰 http.sslVerify false 全局关验证——这既不安全，VSCode 也不一定读这个配置。
- 正确做法：把企业 CA 根证书导入系统信任库
— Windows：双击证书 → “安装证书” → 存入“受信任的根证书颁发机构”
— macOS：security add-trusted-cert -d -r trustRoot -k /System/Library/Keychains/SystemRootCertificates.keychain your-ca.crt
— Linux：按发行版把证书放进/usr/local/share/ca-certificates/后运行update-ca-certificates - 临时救急（仅限当前仓库）：
git -C /path/to/repo config http.sslVerify false，避免污染全局 - PAT URL 必须带
oauth2:前缀：https://oauth2:your_pat_token@gitlab.internal/group/project.git，少一个字符都不行
权限错误：Bad owner or permissions on /home/user/.ssh/config
Linux/macOS 下，SSH 对文件权限极其敏感。VS Code 从桌面图标启动时，可能继承宽松 umask，导致 ssh 拒绝读密钥——此时 VSCode 里所有 Git 操作都会静默失败或卡住。
- 修复权限：
chmod 700 ~/.ssh && chmod 600 ~/.ssh/id_ed25519 && chmod 600 ~/.ssh/config && chmod 644 ~/.ssh/id_ed25519.pub - 如果用的是 VS Code Desktop（.deb/.rpm/.pkg），优先从终端启动：
code .——这样能继承 shell 的ssh-agent环境 - Windows 用户注意：WSL 里的密钥 ≠ Windows 版 VS Code 能读的密钥，别混用；用 Windows OpenSSH 生成并管理密钥更稳妥
最常被忽略的一点：VSCode 识别仓库的前提是工作区必须是 .git 所在的根目录。哪怕只多进了一层文件夹，左侧源代码管理面板就显示“未初始化仓库”——和 GitLab 连不连得上无关，纯路径问题。
