VSCode的Git集成默认用git pull --rebase更安全，但需确保工作区干净；有未提交变更时应先stash再同步；可关闭git.pullRebase改用merge；推送失败须通过Output面板查Git日志定位原因。
VSCode 的 Git 集成足够日常团队协作使用，但默认配置和界面交互容易让人误操作——比如 git pull 时没处理好本地未提交变更，或 git push 失败后不知道该看哪条提示。
如何安全地拉取远程更新并自动合并当前分支
VSCode 底部状态栏的同步按钮（↗️）默认执行 git pull --rebase，不是传统 git pull。这对多数团队更安全，但前提是本地没有未提交的修改，否则会中止 rebase 并留下冲突标记。
- 确认工作区干净：检查 VSCode 源代码管理视图顶部是否显示“无更改”，或终端运行
git status确认无modified/untracked文件 - 若存在未提交变更又想先拉新代码：用
git stash临时保存，再点击同步按钮，最后git stash pop - 想改回传统 merge 方式：在 VSCode 设置中搜索
git.pullRebase，取消勾选；此后同步按钮等价于git pull
为什么点击“暂存更改”后文件没出现在源代码管理面板的“暂存的更改”区
常见原因是文件被 .gitignore 忽略，或 VSCode 当前工作区不是 Git 仓库根目录（比如打开了子文件夹而非项目根）。
Git Log Summary
下载
生成Markdown格式的Git提交摘要报告。适用于需以Markdown输出仓库详细统计的场景。输出包含项目信息、分支、提交统计、作者统计、最近提交记录及提交类型统计等，均以Markdown呈现。
- 检查右下角状态栏是否显示分支名（如
main）和 “0” 提交计数；不显示说明 VSCode 没识别到 Git 仓库 - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Git: Refresh强制重载仓库状态 - 确认
.git文件夹存在于当前打开文件夹的顶层；否则用File > Open Folder重新打开项目根目录
推送失败时 VSCode 只提示“rejected”，该怎么定位具体原因
这个错误几乎总是因为远程分支有新提交而本地落后，但 VSCode 默认隐藏了详细错误日志。必须点开源代码管理面板右上角的“…”，选择 Toggle Output，再在输出面板下拉菜单中选 Git 查看完整报错。
- 典型输出含
! [rejected] main -> main (non-fast-forward)：说明需先git pull再 push - 若含
pre-receive hook declined：通常是权限问题或 CI 检查失败，需联系管理员 - 推送前建议始终先点底部状态栏分支名，选择
Fetch，再对比本地与远程的提交哈希是否一致
真正卡住团队协作的，往往不是功能不会用，而是某次 git commit 没写清楚 message，或者把 node_modules 误加进了暂存区——这些 VSCode 不会替你判断，得靠习惯和预检机制来兜底。
