Git 提交前必须配置 user.name 和 user.email，否则报错无法提交；该配置由 Git 管理而非 VS Code，全局配置一次即可生效所有项目，本地配置优先级更高，VS Code 仅读取不提供编辑入口。
Git 提交前必须配置 user.name 和 user.email
VS Code 本身不管理 Git 用户身份，它只是调用你系统里装的 Git。所以「在 VS Code 中添加用户名」本质是给 Git 配置 user.name —— 否则每次 git commit 都会报错：*** Please tell me who you are.，根本没法提交。
这个配置不是 VS Code 插件或设置项，而是 Git 的底层要求。你哪怕只用命令行提交一次，也绕不开它。
全局配置最省事：一条命令搞定所有项目
绝大多数人只需要一次配置，之后所有新旧仓库都自动生效。打开 VS Code 内置终端（Ctrl+`），直接运行：
git config --global user.name "zhangsan" git config --global user.email "zhangsan@company.com"
- 用户名建议用真实姓名拼音，别用昵称或 ID（GitHub/GitLab 会拿它和账户关联）
- 邮箱必须是你注册代码平台时用的那个，否则提交记录不会显示绿色 verified 标记
- 配置后不用重启 VS Code，下次点「提交」按钮就自动带上你设的作者信息
为什么改了还不生效？检查配置优先级和作用域
Git 有两层配置：全局（~/.gitconfig）和本地（.git/config）。本地配置优先级更高——如果你进过某个项目目录并执行过不带 --global 的 git config user.name，那这个项目就会无视全局设置。
排查方法：
- 在项目根目录下运行
git config user.name，看输出是不是你想要的 - 如果输出为空，说明没配本地，会 fallback 到全局；如果输出不对，说明本地被覆盖了
- 想清掉本地配置？进项目目录，执行
git config --unset user.name和git config --unset user.email
VS Code 界面里看不到用户名设置入口
别在 VS Code 的 Settings（设置）里找「Git 用户名」选项——它压根不存在。所有用户身份都由 Git 命令行控制。你看到的提交记录作者，完全取决于 git config 的结果。
顺带一提：VS Code 的源代码管理面板右下角显示的「Author」，就是当前仓库读到的 user.name 值。它只是个只读展示，不能点进去编辑。
真正容易被忽略的是：公司电脑上如果之前有人配过全局 user.name，你新装 Git 后不手动覆盖，提交就会顶着别人的名字——这种问题往往要等 PR 被打回才发现。
