python文件不显示在scm面板，根本原因是git上下文未激活：必须确保项目根目录含.git文件夹、git.path配置正确、通过“打开文件夹”而非单文件启动，且左下角显示分支名、scm显示“changes”才算就位。
Python文件不显示在SCM面板？先确认Git上下文是否激活
VSCode里Python文件改了却不出现在源代码管理（SCM）面板，90%不是Python配置问题，而是Git根本没被识别。SCM只响应“当前打开的文件夹是Git仓库根目录”这一个条件。
常见错误现象：No source control providers are registered、左下角无分支名、右键菜单没有Git: Stage Changes选项。
- 检查项目根目录是否存在
.git文件夹；没有就先运行git init或git clone - 关闭当前窗口，用
文件 → 打开文件夹重新选择含.git的父目录（不能只打开src/子目录或单个.py文件） - 左下角出现
main（或master）等分支名，且SCM面板显示CHANGES，才算真正就位
git.path配置错误导致状态不更新
VSCode启动时从系统PATH查找git，不是看“有没有装”，而是看“终端里能不能直接敲git --version”。Windows用户常因安装时没勾选Add Git to the system PATH失败；macOS用户则常见shell配置（如~/.zshrc）里加了PATH，但VSCode GUI启动时没加载该配置。
实操建议：
- 终端执行
git --version，有输出才继续；无输出就重装Git并确保PATH勾选 - macOS：确认
~/.zshrc中有类似export PATH="/opt/homebrew/bin:$PATH"，然后**完全退出VSCode**（不只是Reload Window）再重开 - 手动指定路径更可靠：
"git.path": "/usr/local/bin/git"（macOS/Linux）或"git.path": "C:\Program Files\Git\bin\git.exe"（Windows），注意是git.exe，不是目录 - 改完保存，按
Ctrl+Shift+P输入Git: Show Git Output，看到Using git X.X.X from …才算生效
初始化仓库后仍无法提交？暂存和提交必须分两步
VSCode的Git: Initialize Repository只运行git init，不会自动git add .或弹出提交框。未暂存的文件始终显示为Untracked，SCM面板里点“+”或右键Stage Changes才是关键动作。
容易踩的坑：
- 误以为“点了提交按钮就完事”——其实必须先
Stage，再在提交框输文字后按Ctrl+Enter（仅回车是换行） - 提交后状态栏分支名消失，说明本地分支没关联远程，后续
git push会失败，需先运行git branch --set-upstream-to=origin/main main（按实际远程分支名调整） - 多人协作中，切忌对冲突文件点
Stage All——它会把、<code>=======、>>>>>>标记一起提交，队友拉取后直接看到满屏冲突
推送失败报credential rejected？凭据缓存比密码还顽固
GitHub已停用密码登录，但VSCode的Git集成若缓存了旧凭据（尤其Windows的Windows Credential Manager），就会反复报错。这不是密码错了，而是token过期了。
解决方法很直接：
- Windows：打开
控制面板 → 用户账户 → 凭据管理器 → Windows凭据，删掉所有git:https://github.com条目 - macOS：打开
钥匙串访问，搜索github.com，删掉相关internet password条目 - 之后首次
git push，VSCode会弹出GitHub OAuth窗口，必须点Allow完成授权，不能手动输密码 - 若仍失败，临时改用带token的HTTPS地址：
https://<your_token>@github.com/owner/repo.git</your_token>（token需有repo权限）
Git在VSCode里不是黑盒，但它确实藏起了git status和git log --oneline这类诊断命令——遇到状态异常，先打开集成终端敲这两句，比瞎点界面快得多。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
