核心三步：git安装时path选“命令行及第三方软件可用”，vscode中配置git.path指向bin/git.exe，https方式执行git config --global credential.helper store存凭据。
能直接提交代码到 GitLab，核心就三件事：Git 装对、VSCode 认得 Git、远程认证通了。其他插件或设置都是锦上添花，没这三步，点“提交”按钮只会卡在“正在推送…”或报 fatal: Could not read from remote repository。
Git 安装时 PATH 必须选对
很多人装完 Git，在 VSCode 终端里输 git --version 报 “command not found”，就是这一步错了。安装向导里遇到 Adjusting your PATH environment 页面时，必须选：Git from the command line and also from 3rd-party software。
选另外两个选项（比如只选 “Use Git from Git Bash only”）会导致 VSCode 的集成终端完全找不到 git 命令。
验证方式：
– 打开 VSCode 内置终端（Ctrl + `）
– 输入 git --version，有输出即通过
– 若失败，重装 Git 并严格选对 PATH 项，别跳过
VSCode 要能定位到 git.exe 文件
即使系统 PATH 正确，VSCode 有时仍会“视而不见”，尤其当你装在非默认路径（如 D:Program FilesGit）时。这时需手动指定：
- 打开 VSCode 设置（
Ctrl + ,），右上角点“打开 settings.json” - 添加这一行（路径按你实际安装位置改）：
{"git.path": "D:\Program Files\Git\bin\git.exe"} - 保存后重启 VSCode，再看左下角状态栏是否显示分支名（如
main）——不显示说明还没识别成功
注意：git.path 指向的是 bin\git.exe，不是 cmd\git.exe；后者在某些场景下会触发奇怪的权限错误。
HTTPS 提交总让输密码？用 credential.helper store
用 HTTPS 地址克隆 GitLab 仓库（如 https://gitlab.com/xxx/yyy.git）时，每次 git push 都弹窗要账号密码，是因为 Git 默认不存凭证。解决方法只有一条命令：
git config --global credential.helper store
执行后，第一次推送时输入一次用户名和密码，之后就永久记住了（凭据明文存于 ~/.git-credentials）。不用配 timeout、不用装 Git Credential Manager——对绝大多数内部 GitLab 和个人项目，这就是最稳最简方案。
常见坑：
– 不要混用 SSH 和 HTTPS 地址：如果已用 SSH 克隆，却去配 HTTPS 的 credential，无效
– 如果之前用过 cache，先删掉：git config --global --unset credential.helper，再设 store
SSH 方式连不上？重点查 ssh-add 和 GitLab 公钥绑定
SSH 失败的典型现象是：git clone git@gitlab.com:xxx/yyy.git 卡住，或报 Permission denied (publickey)。这不是 VSCode 的问题，而是本地 SSH 密钥没被正确加载或没绑到 GitLab：
- 生成密钥用
ssh-keygen -t ed25519 -C "your_email@example.com"（优先 ED25519，比 RSA 更安全） - 启动 agent 并加载私钥：
eval "$(ssh-agent -s)"<br>ssh-add ~/.ssh/id_ed25519
- 复制公钥内容：
cat ~/.ssh/id_ed25519.pub，整行粘贴进 GitLab 的Profile → SSH Keys，标题随便填，别漏换行符 - 最后测试：
ssh -T git@gitlab.com，返回Welcome to GitLab才算通
公司内网环境常禁用 SSH，此时别硬扛，直接切回 HTTPS + credential.helper store，效率更高。
真正卡住的地方往往不是“怎么点按钮”，而是 git.path 指错了路径、SSH agent 没跑起来、或者 HTTPS 凭证没存成——这些细节一错，整个流程就断在第一步，后面所有操作都白搭。
