vscode“对比历史代码”分git提交历史和本地时间线两条路径：git需初始化仓库、识别分支、启用git.enabled，查看diff需手动切至diff标签；timeline依赖local history且不持久，跨版本对比须用git: compare with revision或终端git diff。
VSCode 里“对比历史代码”这件事，本质是分两条线：Git 提交历史（可靠、可追溯）和本地时间线（轻量、易丢）。没初始化 Git 仓库，Timeline 就只剩“Local History”，而且最多存 30 天、50 条，关了文件可能就没了。
Git: View File History 调不出？先看分支名在不在左下角
右键文件看不到 Git: View File History，不是插件没装，大概率是 VSCode 没识别到 Git 上下文。检查左下角状态栏有没有显示分支名（比如 main 或 dev）。没有？说明：
• 你只拖了一个文件进来，没用 File → Open Folder 打开整个项目目录
• 项目根目录下压根没有 .git 文件夹
• git.status 在终端里跑出来是空的，文件还没 git add
确认 Git 已启用：设置里搜 git.enabled，必须为 true；再确认当前工作区路径和 .git 所在路径一致（比如别在子目录里开 VSCode，而 .git 在父目录）。
点开提交后看不到 diff？手动切到 Diff 标签
点击某次提交，默认打开的是 Overview 标签，只显示作者、时间、message。真正要看改了哪几行，得手动点顶部的 Diff 标签。如果点了还是空白，常见原因有：
• 该文件在那次提交中是二进制（比如图片、.zip），Git 不做文本 diff，只显示 Binary files differ
• 文件被 .gitattributes 显式忽略（比如设了 *.log -diff）
• 编码异常：文件含 BOM 或混用 UTF-8/GBK，可用 git show HEAD:src/file.js 在终端验证能否正常输出
• 换行符配置导致大量虚假差异：临时把设置 files.eol 改成 \n 再试
Timeline 里“No timeline entries”？新文件没 git add 就不进 Git 历史
Timeline 面板显示空，并非功能失效，而是条件不满足：
• 新建文件即使保存了，只要没执行 git add，Timeline 只会显示 “Local History” 条目（灰色小图标），且这些条目不持久
• Local History 依赖 VSCode 自动快照，但只对未暂存文件生效；一旦 git add，它就退居二线
• 想强制生成一条本地快照？改完别急着关文件，等几秒，或手动执行 Developer: Toggle Developer Tools → 控制台输入 vscode.workspace.saveAll()
• Timeline 右键选 Compare with Workspace 没反应？先点右下角编码，选 Reopen with Encoding → UTF-8
对比两个任意 commit？别指望右键多选，用 Compare with Revision
VSCode 的 Git 历史视图不支持 Ctrl+Click 多选然后一键比——它原生只做单提交上下文浏览。真要对比两个历史版本（比如 abc1234 和 def5678），可靠路径只有两个：
• 命令面板输入 Git: Compare with Revision，粘贴第一个哈希；再右键当前编辑器 → 同样命令粘贴第二个哈希
• 终端更直接：git diff abc1234 def5678 -- path/to/file，输出复制进 VSCode 新建文本查看
跨分支对比前，务必先 git fetch，否则哈希解析失败会报 fatal: bad revision 'xxx'
真正容易被忽略的点是：Timeline 的“本地记录”根本不是 Git 记录，它不参与推送、不跨机器、不保证存在——只适合救急回溯“我两小时前删了哪段”。所有需要长期可追溯的操作，必须走 git add + git commit 这条链路。
