Pylance必须手动启用才能生效，关键三步：设置python.languageServer为Pylance、配置python.defaultInterpreterPath指向真实环境路径、添加from future import annotations开启类型推断。
Pylance 必须启用，否则类型提示基本不生效——你看到的“没提示”“标红不准”，八成是它压根没跑起来。
怎么确认 Pylance 正在运行
VSCode 右下角状态栏会显示当前语言服务器。如果看到 Microsoft Python Language Server、空白，或者根本没标识，说明 Pylance 没启用。
点那个区域可以手动切换，但更可靠的做法是检查设置：
- 打开设置（
Ctrl+,），搜索python.languageServer，值必须是Pylance（不是Default或Microsoft） - 同时搜
python.defaultInterpreterPath，确保指向你实际用的 Python 环境，尤其是虚拟环境路径要写对，比如./venv/bin/python（macOS/Linux）或.\venv\Scripts\python.exe（Windows） - 如果之前装过非微软官方的旧版 Python 扩展，直接卸载——它和 Pylance 冲突
为什么加 from __future__ import annotations 能让提示变准
这行不是可有可无的装饰，它是 Pylance 类型推断的关键开关。不加的话，函数返回类型、类内前向引用（比如 A 类里用到还没定义的 B 类）会直接“失联”，报 Unable to resolve function 或补全消失。
立即学习“Python免费学习笔记（深入）”；
- 适用于 Python 3.7+，纯编译期行为，完全不影响运行
- 放在文件顶部，
#!/usr/bin/env python下一行即可 - 尤其在定义互相引用的类、泛型类、或大量使用
-> Self的场景下，不加就等于关掉一半提示能力
pyrightconfig.json 哪些配置最值得加
这个文件放在项目根目录，比 VSCode 全局设置更精准，也避免扫错目录拖慢响应。
-
"include": ["src", "tests"]—— 明确告诉 Pylance 只查哪些目录，别去翻venv或.git -
"exclude": ["**/migrations", "**/__pycache__"]—— 排除干扰，提速且减少误报 -
"reportGeneralTypeIssues": "none"—— 如果被Cannot assign member这类泛型警告刷屏，关它；但别设成"off"，否则真错误也看不到 - 别碰
typeCheckingMode：设成"basic"就够用，"strict"容易因第三方库缺 stubs 导致满屏报错
类型提示写得再好，这些地方照样不补全
Pylance 补全依赖 AST + 显式 import + 类型注解，不是运行时推理。以下情况必然失效：
- 动态属性访问：比如
obj.__dict__['xxx']或getattr(obj, name)—— 字符串内容无法静态确定，Pylance 直接放弃 - 未显式 import：只写了
import requests，却想补requests.get的参数？不行。必须from requests import get或用requests.get全路径调用 - 第三方库没带类型 stubs：比如老版本
celery，补全就断。解决办法是装对应types-xxx包（如pip install types-celery），或局部加# type: ignore抑制，但别全局关检查
类型提示本身不难写，难的是让整个工具链连通——解释器路径、语言服务器、导入方式、配置范围，漏一环，提示就掉半截。尤其 python.defaultInterpreterPath 和 from __future__ import annotations 这两点，90% 的“提示不准”问题都卡在这儿。
