Partial Diff插件跨文件比对需用命令面板触发而非右键；Vue/TSX中需在settings.json配置"partialDiff.enableForLanguages"启用语言支持；HTML标签块整行标红多因换行符或空格不一致，可通过预处理规则统一。

Partial Diff 插件本身不依赖 VSCode 配置文件（settings.json）就能工作，但默认行为在跨文件比对时容易失败——关键不是“怎么配”，而是“哪些配置项必须关/必须开”才能让选中即比真正可靠。

为什么跨文件选两段代码右键没反应

VSCode 原生限制：Partial Diff 的 Compare Selected Texts 命令默认只在**同一标签页内**生效。跨文件时，即使你按住 Ctrl/Cmd 分别选中两个文件里的代码块，右键菜单里 Partial Diff: Compare Selected Texts 仍是灰色的。

• 这不是插件 bug，是 VSCode 编辑器 API 层面对多编辑器上下文的限制
• 插件作者明确说明：跨文件场景下，必须用命令面板触发，不能依赖右键菜单
• 验证方法：打开两个文件 → 分别选中一段 → 按 Ctrl+Shift+P 输入 Partial Diff: Compare Selected Texts，只要两个选区都存在，命令就能执行

如何让 Partial Diff 支持 Vue/TSX 中的 template 标签块

默认情况下，插件在 .vue 或 .tsx 文件的 <template> 区域里无法识别完整标签块（比如选中 <div>...</div> 后右键无选项），因为插件未被激活到这些语言模式。

VSCode

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

下载

• 打开 settings.json，添加：

  "partialDiff.enableForLanguages": ["vue", "typescriptreact", "html"]

• 如果用的是 Volar（非 Vetur），还需加 "vue"；若用 Astro，则加 "astro"
• 改完保存后，重启 VSCode 标签页（不用全重启）即可生效
• 注意：不要加 "json" 或 "markdown" 这类纯文本语言，它们默认已支持

对比 HTML 标签块时总出现整行标红，怎么调忽略规则

常见于比对 <slot>、<template> 或带空格缩进的组件标签——差异高亮不是逻辑不同，而是换行符或空格数量不一致。

• 先确认两个选区末尾是否都有空行： 多一个就多一行“新增”
• 在 settings.json 中启用预处理：

  "partialDiff.preComparisonTextNormalizationRules": [
    { "pattern": "\r\n", "replacement": "\n" },
    { "pattern": "\s+$", "replacement": "" }
  ]

• 上述规则会统一换行符为 ，并删掉每行末尾空白，避免因格式化工具导致误报
• 如需临时关闭忽略空格，右键 Diff 视图 → Toggle Ignore Whitespace（快捷键 Ctrl+Shift+I）

剪贴板比对失败的三个硬性条件

Partial Diff: Compare with Clipboard 看似简单，但有三个系统级前提缺一不可：

• 剪贴板内容不能为空 —— 复制后立刻试，别等几秒，macOS 的剪贴板管理器可能清空它
• 当前编辑器必须处于焦点状态（即光标在代码里闪烁），否则插件读不到活动文档
• VSCode 必须有权限访问剪贴板：macOS 上检查「系统设置 → 隐私与安全性 → 安全性与隐私 → 辅助功能」中 VSCode 是否勾选；Windows 上检查「设置 → 隐私 → 剪贴板」是否开启
• 如果仍报错 Clipboard is empty，终端执行 pbpaste | wc -c（macOS）或 Get-Clipboard | Measure-Object（PowerShell）验证系统级剪贴板是否真有内容

真正卡住人的，从来不是插件装没装，而是跨文件时忘了用命令面板、Vue 文件里没手动启用语言支持、或者复制完没立刻比——这三个动作之间，差的不是按键，是 VSCode 对“上下文”的严格认定。