根本原因是语言服务器未获取足够正确的上下文，需通过正确配置tsconfig.json/jsconfig.json的include与paths、使用多根工作区、为Python设置extraPaths，并等待索引完成来解决。
大型项目中符号引用解析变慢、跳转失败、重命名漏改，根本原因不是 VSCode 性能差，而是语言服务器没拿到足够或正确的上下文。优化方向非常明确：让 TypeScript Server（或 Pylance/gopls）准确、快速地构建完整符号表。
tsconfig.json 或 jsconfig.json 的 include 必须覆盖全部源码目录
TypeScript 语言服务默认只索引打开的文件和直接依赖项，include 字段才是告诉它“整个项目哪些路径属于你管的范围”。漏掉子包、工具库或 shared 目录，就等于主动屏蔽跨项目引用。
- 错误写法：
"include": ["src/**/*"]—— 忽略了packages/utils和libs/core - 正确写法：
"include": ["src/**/*", "packages/**/*", "libs/**/*", "types/**/*.d.ts"] - 避免通配符爆炸：
"**/*.ts"可能拖垮索引，优先用明确路径前缀 - 配合
exclude排除 node_modules、dist、build 等无关目录，减少扫描噪音
路径别名（paths）必须与运行时一致且被语言服务识别
VSCode 不会自动理解 @/components 这种 Webpack/Vite 别名。如果 jsconfig.json 里没配 compilerOptions.paths，重命名 import { Button } from "@/components/ui" 中的 Button，很可能找不到定义位置。
- 确保
baseUrl设为"."，否则paths解析会失效 - 别名值必须是相对于
baseUrl的数组，例如："@utils/*": ["src/utils/*", "packages/shared-utils/src/*"] - 多个匹配路径时，语言服务按数组顺序尝试，把最常用路径放前面
- 重启 TS Server（Ctrl+Shift+P → “TypeScript: Restart TS Server”）才能使新 paths 生效
多根工作区 + 单一语言服务上下文比分散打开更可靠
把十几个子项目各自开一个 VSCode 窗口，等于让十几个语言服务各自建符号表——它们互不通信，跨项目重命名必然失败。而多根工作区（.code-workspace）能让 TypeScript Server 把所有文件视作同一逻辑项目。
- 操作路径：文件 > 将文件夹添加到工作区，选中所有相关 monorepo 子目录
- 保存后检查
.code-workspace是否包含完整"folders"列表 - 关键一步：在工作区设置中启用
"typescript.preferences.includePackageJsonAutoImports": "auto"，帮助识别 package exports - 禁用不必要的插件（如老旧的 TSLint、冲突的 JavaScript 插件），避免语言服务抢占或降级
Python 项目必须显式配置 python.analysis.extraPaths
Pylance 默认只解析当前工作区根目录下的代码。如果你有 common-lib/ 放在项目外，或者使用 poetry/pdm 管理多源码目录，不加配置就不可能跨引用跳转。
- 在工作区设置（.vscode/settings.json）中添加：
"python.analysis.extraPaths": ["../common-lib/src", "./subproject/src"] - 路径必须是相对于工作区根目录的相对路径，不能用
~或环境变量 - 确认 Pylance 已启用：设置中搜索
python.defaultInterpreterPath并指向正确 Python 环境 - 首次配置后观察输出面板 → “Python Language Server”，等状态变为 “Running” 再测试跳转
最常被忽略的一点：符号解析质量高度依赖语言服务是否完成初始索引。刚打开大型工作区时，右下角可能显示 “Indexing…” 或 “Analyzing…”，此时任何跳转或重命名都不可靠。务必等状态稳定、CPU 占用回落后再操作，否则你以为修好了，其实只是缓存没刷全。
