GitLab私有实例远程URL必须用SSH或带PAT的HTTPS：SSH需配置密钥并粘贴公钥到GitLab，HTTPS需用oauth2:TOKEN格式URL；自签名证书应导入系统根证书库而非禁用sslVerify；VSCode识别仓库要求工作区为.git根目录且URL格式正确。
能连上，但默认 HTTPS 方式在企业内网 GitLab 上大概率失败——不是 VSCode 的问题，是认证方式和证书配置没对。
GitLab 私有实例的远程 URL 必须用 SSH 或带 PAT 的 HTTPS
企业 GitLab 通常禁用密码登录，git push 时输用户名密码会直接报错 remote: HTTP Basic: Access denied。这不是权限没开，而是服务端根本没启用该认证方式。
- 推荐优先用 SSH：生成
ssh-keygen -t ed25519 -C "your@work.email"，把~/.ssh/id_ed25519.pub内容粘贴到 GitLab 的 Settings → SSH Keys 里 - 如果公司策略禁用 SSH（比如防火墙封了 22 端口），改用 HTTPS + PAT：在 GitLab 生成 Personal Access Token，权限至少勾选
read_repository和write_repository；然后把远程 URL 改成https://oauth2:<code>PAT_TOKEN@gitlab.example.com/group/project.git - 别信 VSCode 终端里弹出的“输入用户名/密码”框——它不会自动帮你填 PAT，只会卡住或报错
自签名证书导致 git clone 失败：不要关 http.sslVerify
私有 GitLab 常用自签名证书，git clone https://... 会报错 SSL certificate problem: self signed certificate in certificate chain。临时设 git config --global http.sslVerify false 虽能绕过，但生产环境极不安全，且 VSCode 内置 Git 可能不读这个配置。
- 正确做法是把企业 CA 根证书导入系统信任库：Windows 加入“受信任的根证书颁发机构”，macOS 用
security add-trusted-cert命令 - 导入后，VSCode 终端和图形界面 Git 操作都会生效，无需额外配置
- 如果暂时做不到，可只对当前仓库禁用验证：
git -C /path/to/repo config http.sslVerify false，避免全局污染
VSCode 识别不到 GitLab 远程仓库：检查 .git/config 里的 url 格式
即使 git remote add origin ... 成功，VSCode 左侧源代码管理面板仍显示“未初始化仓库”，大概率是远程 URL 格式不被识别。
- SSH 地址必须以
git@gitlab.example.com:group/project.git形式（冒号分隔），不能写成ssh://git@gitlab.example.com/group/project.git（VSCode Git 插件对这种格式支持不稳定） - HTTPS 地址必须含完整域名和 .git 后缀，例如
https://gitlab.example.com/group/project.git；少个.git或多一层路径（如/projects/project）都可能导致推送失败 - 执行
git remote get-url origin确认实际值，再用git remote set-url origin ...修正
GitLens 插件报 “No repositories found”：不是插件坏了，是工作区没打开对
装好 GitLens 后点开 VSCode，底部状态栏没显示分支名，GitLens 提示 “No repositories found”，常见原因是工作区没落在 Git 仓库根目录下。
- 必须用 VSCode 的 File → Open Folder 打开包含
.git文件夹的目录，不能只打开单个文件或父级空文件夹 - 如果已打开错误路径，按
Ctrl+K Ctrl+O重新选择正确文件夹，GitLens 会立刻刷新 - GitLens 默认过滤提交记录用的是
user.name，确保git config --global user.name和你在 GitLab 设置的姓名一致，否则历史记录可能为空
企业 GitLab 集成最常卡在认证链和证书信任上，而不是 VSCode 本身。先确认 git clone 命令行能通，VSCode 才可能正常——图形界面只是壳，底层全是 Git CLI 在跑。
