vscode 中 ctrl+shift+o/ctrl+t 搜不到 python 符号，主因是 pylance 语言服务器未正确识别文件类型、索引未完成、解释器配置错误或符号本身不可静态推导（如中文名、私有成员、动态定义等）。
Python 符号在 VSCode 里搜不到，基本不是你代码写得不对，而是语言服务器压根没把那个函数当“符号”看——Ctrl+Shift+O 和 Ctrl+T 都依赖 Pylance（或旧版 Python 扩展）完成静态分析和索引，一旦这层断了，搜索就成盲搜。
为什么Ctrl+Shift+O在当前.py文件里也找不到函数？
这是最常被误判为“VSCode坏了”的场景，实际几乎全是语言识别链路中断：
- 右下角状态栏显示的是
Plain Text或Auto Detect，而不是Python—— 点它手动选Python，别信自动识别 - 文件后缀不是
.py（比如临时存成script.txt），或虽是.py但内容以#!/usr/bin/env python3开头且没装 Shell 脚本扩展，Pylance 可能直接跳过解析 - 函数定义在
if False:、try/except未触发分支、或字符串里（如exec("def foo(): pass")），Pylance 默认不索引不可达/动态生成的代码 - 用了
globals()["foo"] = lambda: ...这类运行时赋值，静态分析无法推导符号存在
Ctrl+T 搜不到其他文件里的 def 或 class？检查工作区索引是否真在跑
Ctrl+T 不是 grep，它靠 Pylance 构建跨文件符号数据库。很多用户改完代码立刻搜，结果为空——其实是索引还没做完：
- 首次打开大型 Python 项目时，右下角会显示
Indexing Python files...，持续几秒到几分钟不等，期间Ctrl+T返回空结果属正常 - 确认
settings.json中没禁用索引："python.analysis.extraPaths"配错路径、或"python.defaultInterpreterPath"指向一个没装pip install pylance的环境，都会导致索引静默失败 - 如果项目含
pyproject.toml或setup.py，确保它没被files.exclude或search.exclude规则意外排除——Pylance 依赖这些文件判断包结构 - Windows 用户注意：某些杀毒软件会锁住
.vscode\extensions\ms-python.pylance-*下的缓存文件，导致索引卡死，可临时禁用实时防护测试
重置索引不能只靠重启，要分三步清干净
单纯关掉再开 VSCode，大概率只是重载了损坏的缓存。真正有效的重置必须覆盖语言服务器、Pylance 缓存、以及 Python 解释器上下文：
- 先执行命令面板
Ctrl+Shift+P→ 输入Python: Restart Language Server，等状态栏提示Language server restarted - 再执行
Ctrl+Shift+P→Developer: Reload Window，强制刷新 UI 层与 LSP 连接 - 最后，在终端里手动删 Pylance 缓存目录（路径因系统而异）：
%USERPROFILE%\AppData\Roaming\Code\Cache\Pylance（Windows）~/Library/Caches/com.microsoft.VSCode.ShipIt/Pylance（macOS）~/.config/Code/Cache/Pylance（Linux） - 删完别急着开编辑器——先在终端确认
python -c "import pylance; print('ok')"能通过（说明解释器环境干净），再启动 VSCode
中文变量名、下划线开头、类型注解缺失，都会让符号变“隐形”
Pylance 的符号表默认只收录符合 Python 标识符规范 + 可静态推导的命名。以下情况即使语法合法，也大概率不会出现在 Ctrl+Shift+O 列表里：
- 函数名含中文（如
def 用户登录验证():）或 emoji，LSP 符号索引器直接跳过 - 私有成员（
_helper()、__internal()）默认不参与全局符号索引，除非你在pyrightconfig.json里显式开启"includeInSymbols": true - 没有类型注解的函数参数或返回值，Pylance 可能降级为“弱推导”，导致符号关联断裂——加个
-> None或: str就可能让Go to Definition恢复 -
from module import *导入的符号，Pylance 默认不索引，避免污染全局命名空间；改用明确导入from module import func_a, func_b
最易被忽略的点：Pylance 的索引行为高度依赖你当前激活的 Python 解释器。换了一个 venv、conda env 或系统 Python，它不会自动迁移缓存，也不会提醒你重新索引——此时看到的“搜不到”，其实是旧环境残留的符号快照在作祟。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
