VSCode初次提交需手动初始化仓库、确认工作区路径并显式添加新文件；左下角Git图标灰色因未识别.git目录，应通过Ctrl+Shift+P执行“Git: Initialize Repository”；新增文件属Untracked状态，须在Source Control面板展开Changes下的Untracked区点击+号暂存，空提交信息或无暂存变更将禁用Commit按钮。
VSCode 里做 Git 初次提交，根本不用切终端——但必须手动初始化仓库、确认当前工作区路径、且 git add 不能漏掉新文件。
为什么 VSCode 左侧 Git 图标是灰色的？
不是插件没装，也不是 Git 没装，而是当前打开的文件夹还没被识别为 Git 仓库。VSCode 的 Git 面板只响应已初始化的 .git 目录。
- 检查项目根目录下是否存在
.git文件夹（隐藏），没有就说明没初始化 - 别直接右键“在终端中打开”再敲
git init——VSCode 提供了更稳的图形化入口 - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Git: Initialize Repository，回车即可 - 执行后会在当前工作区根目录生成
.git，左侧 Git 图标立刻变蓝，状态栏也会显示分支名（默认main或master）
新增文件不显示在 Source Control 面板？
VSCode 默认只追踪「已被 Git 知道」的文件。刚创建的 index.js 或 README.md 属于未跟踪（Untracked）状态，不会自动出现在待提交列表里。
Cnb Cool Git
下载
CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
- 看 Source Control 面板顶部，找到
Changes下方的Untracked折叠区，点右侧小箭头展开 - 每个未跟踪文件旁有 + 号，点击即执行
git add <file>；想全选就点... → Add All - 别依赖右键菜单里的 “Stage Changes”——对未跟踪文件它不可用，只有已跟踪文件修改后才出现该选项
- 如果文件名带空格或中文，VSCode 通常能处理，但命令行
git add会要求引号包裹，图形操作反而省心
点击 Commit 按钮没反应？检查这三处
Commit 按钮禁用（灰色）不是 bug，是 Git 强制校验：没有暂存变更（staged changes），就不允许提交。
- 确认
Source Control → Changes区域为空 —— 所有修改必须先add进暂存区，才会移到上方Staged Changes - 输入框里没写提交信息（message）也会锁住按钮；VSCode 不接受空提交，哪怕只打一个英文句点也不行
- 如果用了自定义 Git 提交模板（
commit.template），而模板路径失效，VSCode 可能静默失败——临时删掉.git/config里的committemplate行快速验证
提交后远程仓库还是空的？
本地 commit 完全是离线行为，和远程无关。VSCode 的 “Publish to GitHub” 按钮只在首次推送时出现，且隐含两个前提：已登录 GitHub 账户、当前分支无远程关联。
- 第一次推送到 GitHub，优先点 Source Control 面板右上角的
...→Publish to GitHub，它会自动创建仓库并git push -u origin main - 如果手动配过 remote（比如
git remote add origin https://...），但没设上游分支，VSCode 的推送按钮不会亮起，得先运行git branch --set-upstream-to=origin/main main - 遇到
remote: Support for password authentication was removed错误？说明你输的是账号密码——必须改用 Personal Access Token（PAT），且权限至少勾选repo
真正卡住人的，往往不是命令记不住，而是 VSCode 把 Git 的分层逻辑（工作区 → 暂存区 → 本地仓库 → 远程仓库）藏得太深。每一步缺一环，图标就灰一块，按钮就暗一个——盯住 Source Control 面板里那几个分区名称，比背命令管用。
