默认跳转在大型JS项目中失效，主因是TypeScript Server未完整构建符号数据库：node_modules未排除、内存限制触发OOM、缺少jsconfig.json导致源码路径无法识别。
为什么默认跳转在大型 JS 项目里经常失效
不是插件没装，也不是快捷键按错，而是 VSCode 的 JavaScript 语言服务（TypeScript Server）在超大项目中默认会跳过部分文件索引，或因内存限制直接放弃解析深层依赖。典型表现是：F12 点函数名没反应、Shift+F12 查引用只返回空结果、Peek 定义弹出“No definition found”。这背后通常是符号数据库未完整构建，而非代码写错了。
关键原因有三个：
– node_modules 和 dist 目录未被显式排除，导致语言服务反复扫描无关文件
– TypeScript Server 内存不足，默认限制下容易触发 OOM 并静默降级
– 项目缺少 jsconfig.json 或 tsconfig.json，服务无法识别“哪些是源码根目录”
必须配置的三项核心设置
光装插件不配 config，等于给跑车装拖拉机轮胎。以下三项直接决定跳转是否可用：
-
"files.watcherExclude"：防止系统 inotify 句柄耗尽，尤其在 Linux/macOS 上。必须加"**/node_modules/**"和"**/.git/**" -
"search.exclude"和"files.exclude"要分开设——前者影响 Ctrl+Shift+F 搜索范围，后者影响文件树显示和语言服务扫描路径。建议都包含"**/build"、"**/coverage"、"**/*.log" -
"typescript.tsserver.maxMemory"设为4096（单位 MB），否则服务在 >5k 文件的项目里大概率中途崩溃。这个值不能写成字符串，必须是数字
这些配置统一放在工作区的 .vscode/settings.json 中，不建议放用户全局设置——不同项目对索引粒度的要求差异很大。
jsconfig.json 是 JS 项目的“导航地图”
没有 jsconfig.json，VSCode 就像没地图开车：它不知道你写的 import utils from 'src/utils' 中的 src 对应哪个物理路径。此时跳转要么失败，要么随机指向 node_modules 里的同名包。
一个最小可用的 jsconfig.json 长这样：
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"allowSyntheticDefaultImports": true,
"baseUrl": ".",
"paths": {
"src/*": ["src/*"],
"@components/*": ["src/components/*"]
}
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}
注意点：
– baseUrl 和 paths 必须配对使用，否则 alias 跳转无效
– include 显式声明源码范围，比靠文件扩展名推断更可靠
– 不要删掉 exclude，否则 typescript server 仍会尝试解析 node_modules 里的 .d.ts
Code Outline 插件补足结构盲区
即使跳转功能正常，面对一个 2000 行的 index.js，你依然可能找不到函数定义在哪——因为滚动+搜索太慢。Code Outline 插件能在侧边栏生成实时更新的函数/类/变量树，点击即跳转，且支持跨文件聚合（比如把所有 export function 按字母排序列出来）。
它和内置大纲（Ctrl+Shift+O）的区别在于：
– 内置大纲只读当前文件，Code Outline 可设为“整个工作区”模式
– 支持自定义折叠规则，例如隐藏所有以 _ 开头的私有函数
– 树节点右键可直接“查找所有引用”，省去先跳转再按 Shift+F12 的两步操作
安装后务必打开设置里的 "codeOutline.showInExplorer"，不然图标不会出现在资源管理器里；另外，如果发现树为空，先检查当前文件是否被 files.exclude 规则意外屏蔽了。
最常被忽略的是：Code Outline 的符号提取依赖语言服务已就绪。如果 F12 还不能用，先别急着调它——得先把 jsconfig 和内存配置弄对。
