MacOS下VSCode无法通过Command+Click跳转Vue3自定义组件求助

问题描述 #

同一项目在Windows 10中可通过Ctrl+Click点击自定义组件名称跳转至对应.vue文件，但MacOS Ventura 13.6下无法用Command+Click实现该功能。已尝试重装VSCode、切换其他项目，问题仍存在。

项目使用unplugin-vue-components自动导入组件，已生成components.d.ts文件且运行正常。Windows端自定义组件类型显示正常，Mac端则显示为any；.ts/.js方法及div等原生标签可正常跳转，但el-button这类组件无法跳转。

环境信息 #

• VSCode版本：1.84.0(arm)
• 系统版本：MacOS Ventura 13.6
• unplugin-vue-components: 0.25.1
• TypeScript Vue Plugin (Volar) 1.8.22
• Vue Language Features (Volar) 1.8.22
• PNPM 8.10.2
• Nodejs 20.9.0

解决方案 #

1. 启用Volar Take Over Mode #

Mac下Volar未完全接管类型检查可能导致解析异常：

• 禁用VSCode内置的「TypeScript and JavaScript Language Features」扩展
• 重启VSCode，确保Volar的TypeScript Vue Plugin完全接管类型服务

2. 重新生成类型声明文件 #

删除src/types/components.d.ts和src/types/auto-imports.d.ts，重新执行dev命令触发插件生成：

pnpm dev

3. 清理TypeScript缓存 #

• 删除项目根目录下的.tsbuildinfo文件
• 打开命令面板（Command+Shift+P），执行「TypeScript: Restart TS Server」

4. 验证VSCode文件关联配置 #

确保.vue文件被正确识别：
打开设置（Command+,），添加或确认以下配置：

"files.associations": {
  "*.vue": "vue"
}

5. 升级依赖版本 #

旧版本依赖可能存在Mac平台兼容性问题：

pnpm update unplugin-vue-components

同时在VSCode扩展市场将Volar相关插件更新至最新版。

6. 检查快捷键映射 #

确认Command+Click未被其他功能覆盖：
打开设置（Command+,），搜索editor.gotoLocation.mouseModifiers，确保配置中openDefinitionToSide或goToDefinition关联了cmd键：

"editor.gotoLocation.mouseModifiers": {
  "goToDefinition": "cmd",
  "openDefinitionToSide": "cmd+alt"
}

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