VSCode原生不支持文件夹对比，code --diff仅接受文件路径、资源管理器多选文件夹无Compare选项、命令面板无目录参数支持；可靠方案为：①Compare Folders插件生成差异树，②diff -r命令输出文本后用VSCode查看，③Git伪工作区复用分支Diff能力。
VSCode 原生不支持文件夹对比，任何试图用内置功能直接比对两个文件夹的操作都会失败——这不是你操作错了，是它本来就不提供这个能力。
为什么 code --diff folder1 folder2 会报错 Cannot compare directories
VSCode 的 code --diff 命令只接受两个**文件路径**，传入目录会被底层校验直接拦截。终端里执行 code --diff src/ lib/ 时，VSCode 会立刻抛出 Cannot compare directories 错误并退出。资源管理器中 Ctrl/Cmd 多选两个文件夹 → 右键菜单里“Compare Files”选项始终灰掉，命令面板搜 File: Compare Active File With 也根本不接受目录参数——这些不是隐藏功能没打开，而是接口层压根没定义。
- VSCode 的 diffEditor 是为「文本行级比对」设计的，依赖逐行加载、哈希计算和字符级 diff 算法；文件夹涉及递归遍历、符号链接解析、二进制跳过、权限/时间戳判断等逻辑，超出编辑器核心职责
- 官方明确将文件夹 Diff 划归扩展生态或外部工具，GitHub 上多次 closed issue（如 #1892、#12405）都指向同一结论：不做原生支持
- 别在设置里找
folders.diff.enable这类不存在的配置项，也别试workbench.action.compareFolders—— 命令面板搜不到，就说明没注册
真正能用的三个文件夹对比方案（按推荐顺序）
绕过限制的关键，是把「文件夹差异」转化为 VSCode 能处理的对象：要么生成差异清单供点击跳转，要么调用外部工具输出结构化文本，要么复用 Git 的分支 Diff 能力。
-
Compare Folders 扩展（推荐首选）：安装
moshfeu.compare-folders后，右键任一文件夹 →Compare Folder With→ 选另一文件夹。它会扫描全路径，列出Added/Modified/Deleted文件，并支持点击单个文件直接打开内置diffEditor。注意：它默认只比对修改时间与大小，不校验内容是否一致；若需内容级判断，得手动点开每个Modified项再看 diff -
终端
diff -r+ VSCode 渲染（审计场景首选）：在项目根目录运行diff -r folder1/ folder2/ > diff-report.txt，然后用 VSCode 打开该文本。优势是可grep "Only"快速定位单侧独有文件，或grep "^diff"提取所有变更块；缺点是 JSON/YAML 等格式无语法高亮，且不识别编码差异 -
Git 伪工作区法（仅限双 Git 仓库）：若
folder1和folder2都是独立 Git 仓库，可在folder1内执行git remote add audit ../folder2，然后用 VSCode 的 Git 面板 →Git: Compare with Branch→ 选audit/main。本质是复用 VSCode 的分支 diff 渲染能力，但要求两边都有可比 commit，且.gitignore规则需一致，否则忽略的文件不会出现在差异树中
容易被忽略的文件夹差异陷阱
光看出「哪些文件名不同」只是第一步，审计或同步时真正要命的是那些 diff -r 和 Compare Folders 都不报告的细节：
-
ls -laR对比快照才能发现：文件权限变更（chmod）、所有者变化（chown）、符号链接目标偏移（ln -s指向路径变动）——这些直接影响部署安全性和运行时行为 - 同名文件内容一致但编码不同（如 UTF-8 vs GBK），VSCode
diffEditor会显示整块红绿，甚至报no differences；必须先用iconv统一转码，或在 VSCode 中点击右下角编码标识 →Reopen with Encoding强制重载 - 行尾符不一致（
CRLFvsLF）在文件夹级 diff 中完全不可见，但会导致 Git 提交污染、CI 构建失败；建议在对比前统一执行dos2unix或启用core.autocrlf
文件夹对比没有银弹，关键不在「怎么比」，而在「比什么」——权限、编码、换行符、符号链接这些隐性差异，往往比文件增删更致命，却最容易被自动化工具跳过。
