VSCode“同步更改”功能会实时写入文件，影响Git工作目录状态识别；需禁用files.autoSave或配置自动git add以协调二者行为。
如果您在使用 VSCode 进行代码开发时启用了“同步更改”功能，但发现 Git 仓库中的文件状态未按预期更新或暂存区行为异常，则可能是该功能与 Git 的工作区管理机制发生了交互干扰。以下是针对此现象的具体应用说明与操作处理方式：
本文运行环境：MacBook Air，macOS Sequoia。
一、理解“同步更改”功能与 Git 的关系
VSCode 的“同步更改”并非 Git 原生功能，而是指编辑器在保存文件时自动触发的实时写入行为，它直接影响工作目录中文件的磁盘状态，进而改变 Git 对“已修改”文件的识别结果。该功能本身不操作暂存区或提交历史，但会直接刷新 Git 的工作树快照比对基础。
1、Git 通过比对索引（staging area）与工作目录（working directory）判断文件是否被修改。
2、“同步更改”导致文件内容在保存瞬间落盘，使 Git 立即检测到差异并标记为 modified。
3、若启用“保存时自动暂存”扩展（如 Auto Save + GitLens 配合），则可能在无显式 git add 操作下完成暂存。
二、禁用自动同步以明确 Git 控制权
当需要严格遵循 Git 手动暂存流程时，应关闭编辑器层面的隐式同步行为，确保所有变更状态均由开发者主动确认。
1、打开 VSCode 设置界面（Cmd + ,）。
2、在搜索栏输入 files.autoSave。
3、将下拉选项从 onFocusChange 或 afterDelay 改为 off。
4、重启 VSCode 确保设置生效。
三、启用 Git 扩展增强同步可视化
借助 Git 扩展可将“同步更改”后的文件状态即时映射为 Git 视图中的图标与颜色标识，提升对工作区变更的感知精度。
1、在扩展市场中安装 GitLens 或官方 Git 扩展。
2、保存文件后观察侧边栏 Source Control 视图中文件图标变化。
3、已修改文件显示为 M，新文件显示为 ?，删除文件显示为 D，颜色对应状态高亮。
四、配置保存时自动执行 git add
在保留“同步更改”便利性的同时，使 Git 自动响应文件落盘动作，避免手动暂存遗漏。
1、打开 VSCode 设置，搜索 git.autoRepositoryDetection 并设为 true。
2、在用户 settings.json 中添加："git.postCommitCommand": "none" 和 "git.promptToSaveFilesBeforeCommit": false。
3、安装 Shell Command 扩展，创建自定义任务，在保存后调用 git add ${file}。
