反向搜索功能未激活需依次检查：一、修正sumatrapdf反向搜索命令参数；二、清除注册表inversesearchcmdline项；三、确保pdf含synctex信息并重建；四、用符号链接规避路径问题；五、禁用干扰插件与安全软件。
如果您在SumatraPDF中双击PDF文档任意位置，但VSCode未能跳转至对应.tex源文件及行号，则说明反向搜索功能未正确激活。以下是恢复该功能的多种配置方法：
一、校验并修正SumatraPDF反向搜索命令参数
反向搜索依赖SumatraPDF接收到正确的外部编辑器调用指令，若参数缺失、路径错误或引号不匹配，将导致跳转失败。必须确保VSCode路径、参数格式与SyncTeX协议严格一致。
1、打开VSCode，按下Ctrl+,进入设置，点击右上角“打开设置(JSON)”图标。
2、在settings.json中定位到"latex-workshop.view.pdf.external.synctex.args"字段。
3、将该字段值替换为以下完整参数（请严格按顺序与引号格式复制）：
["-forward-search","%TEX%","%LINE%","-reuse-instance","-inverse-search","\"C:/Program Files/Microsoft VS Code/Code.exe\" -g \"%f:%l\"","%PDF%"]
4、关键检查项：VSCode安装路径必须与上述引号内完全一致；若实际路径含空格（如Program Files），必须用英文双引号包裹整个Code.exe路径；%f与%l之间使用英文冒号且不可加空格。
二、重置SumatraPDF内部反向搜索注册项
SumatraPDF自身维护一个全局反向搜索命令缓存，若此前配置错误或版本升级后残留旧参数，会覆盖VSCode传入的设置。需手动清除并重建该注册项。
1、关闭所有SumatraPDF窗口及后台进程（可在任务管理器中结束SumatraPDF.exe）。
2、按下Win+R，输入regedit，以管理员权限打开注册表编辑器。
3、导航至路径：HKEY_CURRENT_USER\Software\SumatraPDF。
4、在右侧窗格查找名为InverseSearchCmdLine的字符串值，右键删除该项。
5、重新启动SumatraPDF，此时它将完全依赖VSCode通过-synctex参数传递的命令，不再读取本地缓存。
6、验证方式：在SumatraPDF菜单栏依次点击Settings → Options → Advanced Options，在打开的sumatrapdfprefs.txt中确认未出现InverseSearchCmdLine行。
三、强制启用SyncTeX并重建PDF输出文件
即使配置正确，若当前PDF文件编译时未嵌入SyncTeX映射信息，反向搜索仍无法触发。必须确保PDF由支持-synctex=1的引擎生成，且输出文件为全新构建。
1、在VSCode中打开您的主.tex文件，确保LaTeX Workshop插件处于激活状态。
2、按下Ctrl+Alt+B调出编译命令面板，选择latexmk或pdflatex配方（非“Build with recipe”默认项）。
3、在LaTeX Workshop的工具链配置中确认pdflatex命令包含"-synctex=1"参数（位于args数组第一项）。
4、在项目根目录下，手动删除所有中间文件：main.synctex(busy)、main.synctex.gz、main.aux、main.log（保留.tex和.bib等源文件）。
5、执行全新编译，等待PDF生成完毕后再尝试双击反向跳转。
6、重要提示：若使用xelatex或lualatex，请同步确认其args中同样含有-synctex=1；仅pdflatex默认支持，其他引擎需显式声明。
四、绕过路径限制的符号链接方案
当VSCode或SumatraPDF实际安装路径含中文、空格或长路径（如C:\Program Files (x86)\...）导致参数解析失败时，可借助Windows符号链接创建无风险访问入口，从根本上规避路径异常。
1、以管理员身份运行Windows终端（PowerShell或CMD）。
2、执行命令创建VSCode链接：mklink /D "C:\VSCode" "C:\Program Files\Microsoft VS Code"（请按您实际路径调整）。
3、执行命令创建SumatraPDF链接：mklink /D "C:\Sumatra" "C:\Program Files\SumatraPDF"。
4、回到VSCode settings.json，将"latex-workshop.view.pdf.external.viewer.command"与"latex-workshop.view.pdf.external.synctex.command"两项中的路径全部替换为C:/VSCode/Code.exe与C:/Sumatra/SumatraPDF.exe。
5、注意：符号链接路径中禁止出现任何空格或中文；所有斜杠必须为正斜杠/；链接目标路径末尾不带反斜杠\。
五、禁用干扰插件与安全软件拦截
部分安全软件（如火绒、360）、VSCode扩展（如Auto Rename Tag、Prettier）或系统组策略可能拦截进程间命令行调用，导致-inverse-search参数无法送达VSCode。
1、临时退出所有第三方安全软件，包括实时防护与弹窗拦截模块。
2、在VSCode中按下Ctrl+Shift+P，输入Extensions: Show Enabled Extensions，禁用所有非LaTeX Workshop相关插件。
3、重启VSCode与SumatraPDF，仅保留LaTeX Workshop、GitLens（如需）、Bracket Pair Colorizer（低风险）等基础辅助插件。
4、在SumatraPDF中双击PDF任一文字，观察Windows任务栏是否短暂闪现VSCode窗口——若闪现后立即消失，表明调用成功但被插件中断；若完全无反应，则为参数或路径问题。
5、紧急验证：在命令行中直接运行以下命令，确认VSCode能否响应-g参数："C:\VSCode\Code.exe" -g "D:\myproject\main.tex:42"（路径与行号需真实存在）。
