Ctrl+P 是工作区语义导航中枢而非单纯搜文件名；其 @、#、行号及 F12 功能均依赖语言服务（LSP）就绪，配置缺失（如 tsconfig.json）、文件未识别、索引排除或编码问题会导致对应功能失效。
Ctrl+P 不是“搜文件名”的快捷键，而是工作区语义导航中枢——输错前缀，90% 功能就失效。
Ctrl+P 输入 @ 后没反应？检查语言服务是否就绪
输入 Ctrl+P 后跟 @ 是跳转当前文件符号（函数、类、变量）的正确方式，但出现空白或 “no symbols found” 通常不是操作错误，而是语言服务未就绪：
- 文件后缀未被识别（如
.jsx文件右下角显示 “Plain Text”，而非 “JavaScript React”） - 缺少
jsconfig.json或tsconfig.json，导致 TS/JS 语言服务器无法建立跨文件索引 - 文件新建后未保存，部分语言插件对 unsaved 文件不触发符号解析
- 验证方法：按
Ctrl+Shift+P→ 运行Developer: Toggle Developer Tools→ 切到 Console，搜language server或failed，常见报错如No client for file://
Ctrl+P 输入 # 搜索全项目符号却漏结果？排查索引范围
# 模式依赖语言服务器的跨文件符号索引，不是文本 grep。漏匹配常因以下配置问题：
-
"files.exclude"或"search.exclude"把源码目录（如src/lib）误加进排除列表 - monorepo 项目中，
tsconfig.json未设"references"或"include"未覆盖全部子包路径 - 符号定义在
declare module或独立.d.ts中，但当前文件未通过/// <reference types="" />显式引入 - 临时补救：输入
#useState后按Tab，VSCode 会 fallback 到全文本搜索（显示 “Search text in workspace”）
Ctrl+P 输入 filename.ts:42 定位不准？行号跳转受三重干扰
行号定位看似简单，但实际易受编码、换行符和缓存影响：
- 文件含 BOM 头或非 UTF-8 编码（如 GBK），VSCode 行计数可能多算一行
- 启用了
"editor.renderWhitespace": "all"，而文件混用\r\n和\n，导致行号偏移 - 文件正被构建脚本写入，
Ctrl+P读的是旧缓存版本 - 安全做法：先
Ctrl+S保存，再用Ctrl+P → filename.ts:42；若仍不准，改用Ctrl+G（强制实时读取）
F12 / Ctrl+Click 跳转失败？本质是 LSP 没接上
F12 和 Ctrl+Click 都调用语言服务器（LSP）的 textDocument/definition 请求，失败主因不是快捷键问题，而是 LSP 未启动或上下文缺失：
- TS/JS 项目缺失
tsconfig.json或路径配置错误 → 跨文件接口定义跳不到 - Python 文件右下角显示 “Plain Text” → Pylance 不加载，
Ctrl+Click变成纯文本匹配 - 别名路径（如
@utils）未在tsconfig.json的compilerOptions.paths中声明 → VSCode 不知道它指向哪 - 修复后务必运行
Ctrl+Shift+P → TypeScript: Restart TS Server，否则改动不生效
真正卡住人的，往往不是记不住快捷键，而是不知道什么时候该查 Developer Tools 控制台，或者误把 LSP 的能力当成 VSCode 自带功能。一个没配好的 tsconfig.json，能让整个导航链断掉——这不是 bug，是设计使然。
