Ctrl+F12(Mac为Cmd+F12)可跳转到源码实现,因它触发implementation请求并绕过.d.ts;若包未在exports中声明src入口,则仍会fallback至声明文件。

Ctrl+鼠标左键点进去看到的是 .d.ts 而不是 .js 或 .ts 源码,这不是你配错了,是包本身没提供可跳转的实现文件。
为什么 Ctrl+Click 跳进的是 index.d.ts 而不是源码
TypeScript 项目默认优先跳转类型声明(.d.ts),因为 package.json 中的 types 字段明确指向它。VSCode 尊重这个约定,哪怕源码就在 src/ 下,只要 types 没配对,就不会去查 main 或 module。
- 打开
node_modules/包名,看是否存在src/或未编译的.ts/.js文件;如果只有dist/和types/,那确实没有源码可跳 - 若存在源码但跳不过去,检查
package.json里"types"是否指向了dist/index.d.ts,而真实源码在src/index.ts—— 这时需手动改字段或提 PR 给作者 - React、Vue 官方生态包(如
@vue/reactivity)常把types指向声明,main指向编译后代码,这种设计下“跳转到实现”天然不可用
想看真实 JS/TS 实现,该用 Ctrl+F12 而不是 F12 或 Ctrl+Click
F12 和 Ctrl+Click 都走 textDocument/definition 请求,结果受 types 控制;Ctrl+F12 触发的是 textDocument/implementation,它会绕过声明,尝试找实际实现位置(比如 src/ 下的同名文件)。
- 前提是包作者在
package.json中正确配置了"unpkg"、"source"或"exports"字段,否则Ctrl+F12也会 fallback 到.d.ts - 某些包(如
zod)在exports中显式声明了./src/入口,此时Ctrl+F12才有效;没声明则无效 - Mac 用户对应快捷键是
Cmd+F12,不是Cmd+Shift+F12(后者是查找所有引用)
Alt+Shift+Z 快速定位已打开的 .d.ts 文件在哪一层 node_modules
跳进 .d.ts 后卡住?别手动翻路径。先确保该文件已打开(即你已 Ctrl+Click 进去了),再按 Alt+Shift+Z —— VSCode 会立刻在资源管理器中高亮并展开它的父目录,一眼看到它属于哪个子包、在 node_modules 的哪一层。
- 必须手动绑定:打开快捷键面板(
Ctrl+Shift+P)→ 输入Preferences: Open Keyboard Shortcuts (JSON)→ 添加:{"key":"alt+shift+z","command":"workbench.files.action.revealFileInExplorer"} - Mac 用户用
Option+Shift+Z,Cmd键容易和系统冲突 - 这个操作只对“已打开的文件”生效,所以得先完成一次跳转,再按它
Python 和 Java 包的悬浮提示里看不到实现,原因不同但都难绕过
Python 项目点 requests.get 停在 .pyi,Java 点 ArrayList.add 停在反编译的 .class,这不是配置问题,是语言层限制。
- Python:C 扩展模块(如
numpy、cv2)真实逻辑在 C 代码里,.pyi是唯一能提供的接口描述;修改py.typed或换Jedi引擎不影响跳转目标 - Java:VSCode 的 Java 扩展靠
java.home指向 JDK,然后读取src.zip;若 JDK 不含源码(如某些 JRE 发行版),就只能显示反编译结果,且无法跳转到原始.java - 临时补救:Python 可用
Ctrl+Shift+P→Python: Clear Internal Cache;Java 可手动下载对应 JDK 源码包并配置java.configuration.updateBuildConfiguration为interactive
最常被忽略的一点:即使所有配置都对,只要包作者没把源码一起发布(或没在 exports/types 字段里留线索),VSCode 就真找不到——它不会猜,也不会爬 GitHub。这时候,Alt+Shift+Z 定位 + 手动翻 src/ 是唯一靠谱路径。











