VSCode比对本地配置与远程分支需显式触发Git操作：右键文件选“Compare with HEAD”仅对比工作区与最后一次提交；要对比origin/main等远程分支，须用命令面板执行“Git: Compare Branches”，且远程分支须已fetch。
怎么比对本地配置和远程分支里的同名文件
直接右键资源管理器里的配置文件（比如 config.json），选 Git: Compare with HEAD，就能看到你改了什么。如果想比对的是远程分支（比如 origin/main）而不是当前 HEAD，得用命令面板：Ctrl+Shift+P → 输入 Git: Compare Branches → 先选当前分支，再选 origin/main。
常见错误是以为“打开两个文件就能自动比”，其实不会——VSCode 不会凭空猜你要比谁。必须显式触发 Git 比较动作，否则只是两个普通编辑器标签并排而已。
- 如果远程分支还没 fetch 过，
Compare Branches列表里看不到它，先运行git fetch或点左下角 Git 状态栏刷新图标 -
Compare with HEAD只比工作区 vs 暂存区/最后一次 commit；要查暂存前的修改，得选Compare with Index - 配置文件常含敏感字段（如
api_key），建议在 diff 视图里勾选Ignore Trim Whitespace（设置里搜这个选项），避免空格/换行干扰判断
合并时怎么安全保留本地配置又吸收远程更新
当 git merge origin/main 报冲突，VSCode 会自动打开合并编辑器：左边是你的本地修改（Current Change），右边是远程进来的变更（Incoming Change），中间是结果预览。关键不是“全选一边”，而是分块处理。
例如 database.url 字段本地改了测试地址，远程改了超时参数，这时不能点 Accept Both Changes —— 它会把两段 JSON 拼一起，破坏结构。
- 光标停在冲突块内，用
Ctrl+Alt+M（Win/Linux）或Cmd+Alt+M（Mac）呼出菜单，逐个选Accept Current Change或Accept Incoming Change - 手动编辑中间面板时，必须删干净所有
、<code>======、>>>> origin/main标记，否则git add会失败 - 改完保存后，右键文件 →
Stage Changes，不是 Ctrl+S 就算完事
为什么对比 config.yaml 总是高亮一堆无关差异
YAML 和 JSON 对缩进、换行、注释极其敏感，VSCode 默认的行级 diff 容易把格式调整当成逻辑变更。这不是 bug，是文本比对的固有局限。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
解决办法不是关 diff，而是提前“净化”输入：
- 用
yq或prettier统一格式化后再比：yq eval -P config.yaml > config.normalized.yaml - 在 diff 视图右上角点
⋯→Toggle Ignore Whitespace，临时跳过空格/制表符差异 - 避免在配置里写长行注释，YAML 注释后换行容易被 diff 当成新增行
如何让 VSCode 真正调起图形化三路合并来处理配置冲突
VSCode 内置的合并编辑器本质是简化版三路视图，它隐式还原了 base/ours/theirs，但不暴露祖先版本。真要看到三栏原始上下文（比如确认某行到底是谁删的），得配外部工具。
执行 git mergetool 卡在终端？问题几乎都在配置漏项：
- 运行
git config --global merge.tool vscode和git config --global mergetool.vscode.cmd 'code --wait $MERGED' - 必须带
--wait参数，否则 VSCode 启动后命令立即返回，Git 认为没完成 - 如果系统装了多个 VSCode（如 stable + insiders），确保
code命令指向你日常用的那个版本
配置生效后，git mergetool 才会真正拉起 VSCode 的合并编辑器，并完整呈现共同祖先、当前分支、传入分支三方内容——这对理清配置覆盖链特别有用。
