最常见原因是语言服务器索引未同步新增/重命名文件：它基于启动时快照而非实时监听，需手动执行typescript: restart ts server（ts/js）、python: restart language server（python）或go: restart language server（go）刷新索引。
为什么“查找所有引用”没更新新文件里的调用？
符号引用结果不刷新，最常见原因是语言服务器（如 tsserver、gopls 或 Pylance）的索引没同步到新增/重命名后的文件。它不是实时监听文件系统变化，而是基于启动时或上次全量分析的快照——改了文件名、加了新模块、甚至只是改了 tsconfig.json 路径别名，都可能让旧索引失效。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P） - 输入并执行：
TypeScript: Restart TS Server（TS/JS 项目） - Python 项目则执行：
Python: Restart Language Server（需已安装 Pylance） - Go 项目执行：
Go: Restart Language Server（确认gopls可执行且路径在$GOPATH/bin）
哪些操作后必须手动刷新？
不是每次保存都要重启服务，但以下场景几乎必然导致引用丢失，必须干预：
- 新增一个未被
include覆盖的源文件（比如tsconfig.json里"include": ["src/**/*"]，但你把新文件放到了lib/下） - 重命名模块路径（如把
utils/math.ts改成helpers/math.ts，但没更新所有import语句） - 修改了
jsconfig.json或tsconfig.json中的paths别名映射 - 刚克隆项目，首次打开时语言服务尚未完成初始索引（状态栏右下角显示 “TypeScript initializing…”）
怎么确认语言服务真在干活？
光看状态栏“TypeScript”字样不够，得验证它是否加载了你的项目结构：
- 按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 切到 Console 标签页 - 搜
textDocument/references或No references found，如果看到大量报错或空响应，说明索引异常 - 对 TS/JS 项目，可执行
TypeScript: Open TS Server Log查看底层日志，重点找Project loading started和后续的文件扫描记录 - Python 项目检查
pyproject.toml是否存在，或根目录是否有__init__.py—— 缺失会导致 Pylance 不启用模块解析
editor.renameOnType 开了反而更慢？
这个配置让 VSCode 在你输入新名字时实时高亮所有待改位置，但它极度依赖语言服务的响应速度。一旦项目变大或服务卡顿，就会出现：
- 输入卡顿、光标延迟、甚至编辑器无响应
- 预览高亮范围错误（多标/漏标），尤其在嵌套导入或条件导出场景
- 频繁触发
textDocument/rename请求，加重服务器负担
遇到这类问题，直接关掉："editor.renameOnType": false。等重命名动作真正执行（F2 → 输入 → 回车）时再由语言服务做一次准确定位，反而更稳。
真正容易被忽略的是：语言服务索引不是“全量扫描”，而是增量式构建 + 缓存。哪怕你只改了一行 export，也可能需要重启服务才能让跨文件引用重新连通——别省那几秒重启时间。
