compare folders 插件能列出新增/缺失/修改的文件并支持跳转内置 diff 视图，但仅依赖修改时间和文件大小判断变化，不校验内容一致性，无法识别软链接、空目录，也不能对比跨 git 工作区的独立项目路径。
Compare Folders 插件能比什么、不能比什么
它能列出两个文件夹下所有新增/缺失/修改的文件，并支持点击跳转到内置 diff 视图；但它默认只靠修改时间与文件大小判断“是否修改”，不校验内容是否一致。比如你把 config.json 里一个字段值改了但没动时间戳，插件会认为“没变”，实际内容已不同。
常见误判场景：
- Git 仓库中刚
git checkout切换分支，文件内容变了但 mtime 没更新 → 插件标为 “Unchanged” - 用脚本批量生成文件，所有文件都写入同一时间戳 → 插件无法识别内容差异
- 软链接或空目录会被忽略，不参与对比
解决办法：右键对比结果里的文件 → 选 Compare with Working Tree 或手动打开两个文件再走 File: Compare Active File With 做内容级确认。
怎么让 Compare Folders 真正比内容而不是看时间戳
插件本身没提供“强制内容比对”开关，但你可以绕过它——在插件生成的差异列表里，对疑似误判的文件，右键选 Open in New Tab，然后用 VSCode 原生方式比：
- 先打开 A 路径下的文件 → 右键标签 →
Select for Compare - 再打开 B 路径下同名文件 → 右键 →
Compare with 'xxx' - 或者快捷键
Ctrl+Shift+P→ 输入File: Compare Active File With→ 选另一个文件
注意：Compare Folders 不会自动帮你打开这一对文件，它只告诉你“这个文件可能不同”，真要比内容，得你自己触发一次双文件 diff。
tree + comm 组合命令查“结构级缺失”更准
如果你真正关心的是“A 项目有但 B 项目根本没有的目录”，比如 src/middleware 在旧版存在、新版删了，Compare Folders 只会显示“Deleted”，但不会告诉你整个目录树消失了——这时得用 shell 工具拍快照再比。
Linux/macOS 下执行：
find project-a -type d | sort > a-dirs.txt<br>find project-b -type d | sort > b-dirs.txt<br>comm -3 <p>Windows PowerShell 下执行：</p> <pre class="brush:php;toolbar:false;">$a = Get-ChildItem project-a -Recurse -Directory \| ForEach-Object FullName<br>$b = Get-ChildItem project-b -Recurse -Directory \| ForEach-Object FullName<br>Compare-Object $a $b
输出结果粘贴进 VSCode 新建文件，再用 File: Compare Active File With 对比两份路径列表——这才是查“目录级结构性差异”的可靠姿势。
别指望 GitLens 或内置 Git 功能对比两个独立项目
GitLens: Compare Folders 只能在同一 Git 工作区里用，比如 project/src 和 project/test；它不接受 /home/user/project-v1 和 /home/user/project-v2 这种完全独立的路径。同样，Git: Compare Branches 命令也要求两个分支属于同一个 .git 目录。
试图右键一个独立项目的文件夹 → GitLens → Compare Folders → 选另一个磁盘路径，结果只会报错或静默失败。这不是权限问题，是设计边界：GitLens 的 diff 依赖 Git 的索引和对象数据库，没有共享仓库，它连文件哈希都拿不到。
复杂点在于，很多人把“两个克隆下来的仓库”当成“同一项目不同版本”，其实它们是两个孤立的 Git 实例——除非你用 git worktree 或硬链接方式复用 .git，否则所有基于 Git 的对比功能都会失效。
