VSCode「转到引用」功能失效，如何重置恢复？

可能的失效原因 #

• 本地用户配置文件损坏/异常：VSCode重装默认保留用户配置目录，旧配置中的错误设置或损坏文件会持续影响功能，导致跳转失效。
• 工作区配置被意外修改：项目本地的.vscode/settings.json可能被误改，添加了禁用代码跳转相关的配置项。
• 语言服务缓存损坏：VSCode针对JavaScript的语言服务索引、缓存文件损坏，导致无法正常解析代码的定义与引用关系。

恢复功能的步骤 #

重置用户配置（彻底清除旧配置） #

1. 完全关闭VSCode
2. 找到对应系统的用户配置目录：
   • Windows：%APPDATA%\Code
   • macOS：~/Library/Application Support/Code
   • Linux：~/.config/Code
3. 将该目录重命名为Code_backup（备份旧配置）
4. 重新启动VSCode，此时会生成全新的默认配置

检查并重置工作区配置 #

• 打开项目根目录下的.vscode/settings.json，检查是否存在以下类似禁用跳转的配置：

  "javascript.suggest.enabled": false,
  "editor.gotoLocation.multipleDefinitions": "never",
  "javascript.referencesCodeLens.enabled": false
  

• 若有上述配置，直接删除或恢复为默认值（删掉对应行即可）

清除VSCode缓存 #

1. 打开VSCode，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板
2. 依次执行以下命令：
   • Developer: Reload Window（重载窗口）
   • Developer: Clear Workspace Cache（清除工作区缓存）
   • Developer: Clear Editor History（清除编辑器历史）

排查扩展冲突 #

1. 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），执行Extensions: Disable All Installed Extensions
2. 重启VSCode，测试「转到引用」功能是否恢复
3. 若功能恢复，逐个重新启用扩展，每次启用后重启测试，找到导致冲突的扩展并卸载

内容的提问来源于stack exchange，提问作者EcmaScriptIsMyNativeLanguage