code --diff 是唯一能绕过 UI 直接触发文件对比的命令行方式，需提供两个完整绝对路径，路径含空格或中文须用英文双引号包裹，不支持相对路径、通配符和 ~ 符号。

code --diff 命令行参数是唯一能绕过 UI 直接触发对比的方式

VSCode 不支持在已运行实例中通过命令行追加 --diff 来打开新对比窗口——它只会启动新窗口（哪怕已有实例）。所以这个操作本质是“启动一个专用的、仅用于比对的 VSCode 实例”，适合脚本调用、CI 日志检查或临时比对场景。

• code --diff 必须跟两个**完整绝对路径**，相对路径、通配符、~ 符号都会失败
• 路径含空格或中文时，必须用英文双引号包裹，例如：code --diff "/Users/me/Desktop/配置备份.json" "/Users/me/Downloads/最新配置.json"
• 如果目标文件不存在，VSCode 会静默创建空文件并对比——不是报错，容易误判为“比对成功”
• 该命令不读取当前工作区设置，所有 diff 行为按用户全局设置（settings.json）生效，比如 diffEditor.ignoreTrimWhitespace

Windows 下需注意 cmd/powershell 的路径处理差异

PowerShell 默认把反斜杠 当转义符，直接写 code --diff C:ile1.txt C:ile2.txt 会报错“无法识别的参数”。必须改用正斜杠或双反斜杠：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 推荐用正斜杠：code --diff C:/a/file1.txt C:/b/file2.txt
• 或双反斜杠：code --diff C:\a\file1.txt C:\b\file2.txt
• cmd.exe 相对宽容，但路径含空格仍需双引号

对比窗口关闭后，进程不会自动退出

执行 code --diff 启动的 VSCode 实例，即使你关掉所有编辑器标签页，主窗口最小化或隐藏后，进程仍在后台运行。多次执行会累积多个 Code Helper 进程，占用内存。

• 想彻底退出，必须手动关闭窗口（macOS 点红叉，Windows 点右上角 ×），不能只关 Diff 标签页
• 脚本中如需自动清理，可在启动后加 && sleep 5 && osascript -e 'quit app "Visual Studio Code"' （macOS）或用 taskkill（Windows），但有风险——可能误杀其他 VSCode 实例
• 更安全的做法是：用 code --diff + --new-window 组合，并在对比完成前不重复调用

编码不一致会导致“no differences”或整行标红

code --diff 是字节级比对，不自动探测编码。若一个文件是 UTF-8 with BOM，另一个是 GBK，VSCode 会把每个字节当独立字符处理，结果几乎全红全绿，甚至显示 no differences（因 BOM 导致首行哈希错位）。

• 比对前先确认编码：用 file -i path/to/file（macOS/Linux）或 PowerShell 的 Get-Content -Path file.txt -Encoding Byte | Select -First 4 查 BOM
• 统一为 UTF-8（无 BOM）：用 VSCode 打开文件 → 右下角点击编码名 → Reopen with Encoding → 选 UTF-8 → 再点一次 → Save with Encoding
• 换行符也要一致（LF vs CRLF），否则每行末尾都被视为差异

实际用得最多的是第一种方式，但很多人卡在路径写法和编码上——这两个点不解决，code --diff 看起来就像失效了。