pylance必须手动启用并配置正确才能正常工作：状态栏确认运行、设置python.languageserver为pylance、指定正确解释器路径；添加from future import annotations启用新式注解解析；合理配置pyrightconfig.json；避免动态属性、隐式导入及缺失stubs导致补全失效。
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 3.7+，纯编译期行为，完全不影响运行
- 放在文件顶部，
#!/usr/bin/env python下一行即可 - 尤其在定义互相引用的类、泛型类、或大量使用
-> Self的场景下，不加就等于关掉一半提示能力
pyrightconfig.json 哪些配置最值得加
这个文件放在项目根目录，比 VSCode 全局设置更精准，也避免扫错目录拖慢响应。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
-
"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或import requests后用requests.get - 第三方库没带 stubs（如旧版
celery）—— 安装对应types-xxx包，或手动加# type: ignore抑制，但别关整个检查
类型提示越具体，Pylance 越敢补全。一个 def foo(x: list[str]) -> dict[int, bool]: 比 def foo(x): 强太多。
真正容易被忽略的是：即使所有配置都对，只要某个文件没加 from __future__ import annotations，它里面的前向引用和泛型就大概率“看不见”。这不是 bug，是设计如此——Pylance 默认按旧式注解解析，那行就是开关。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
