Pylance类型检查默认关闭，需手动配置"python.analysis.typeCheckingMode":"basic"启用；必须确保状态栏显示Pylance紫色图标、python.languageServer设为Pylance、python.defaultInterpreterPath指向正确解释器路径。
Pylance 的类型检查默认是关闭的，必须手动启用 basic 或 strict 模式才能看到类型错误提示——不配就等于没用。
确认 Pylance 已启用且状态栏显示正确
VS Code 启动后右下角状态栏必须显示 Pylance（带紫色图标），而不是 Microsoft Python Language Server 或空白。点它可临时切换，但容易回退，根本解法是锁死设置：
- 打开设置（
Ctrl+,），搜python.languageServer，值必须为Pylance（不是Default） - 搜
python.defaultInterpreterPath，确保指向你实际用的 Python 解释器，尤其是虚拟环境路径（如./venv/bin/python） - 如果之前装过非官方 Python 扩展（比如旧版“Python for VS Code”），务必卸载——它会劫持语言服务器，导致 Pylance 不加载
开启 typeCheckingMode 并选对模式
python.analysis.typeCheckingMode 是控制类型检查开关的核心配置，它不依赖外部工具（如 mypy），纯靠 Pylance 内置的 Pyright 引擎实时运行：
- 设为
basic：推荐绝大多数项目。报Cannot assign to "xxx"、Argument of type "str" cannot be assigned to parameter "int"这类基础错误，不影响编辑速度 - 设为
strict：仅在强类型需求场景（如 SDK 开发、团队强约束）启用。会检查未注解函数返回值、隐式 any、泛型协变等，误报率略升，补全响应可能变慢 - 设为
off：等于关掉所有类型提示能力，补全质量明显下降（尤其跨文件跳转和参数提示）
配置位置：用户设置 JSON（Ctrl+Shift+P → Preferences: Open Settings (JSON)）中加一行：
"python.analysis.typeCheckingMode": "basic"
为什么加 from __future__ import annotations
这行不是可选项，而是 Pylance 类型推断的“启动密钥”。不加它，很多地方类型直接丢失：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 类内部方法返回
self 或其他本类实例时，Pylance 会报Unable to resolve function - 两个类互相引用（A 中用 B，B 中用 A），不加这句，其中一个类的方法补全完全不可见
- 函数返回类型写成
-> MyClass（而非-> "MyClass"）时，Pylance 无法解析前向引用 - 只影响提示，不改变运行行为；Python 3.7+ 兼容，放在文件首行（
#!/usr/bin/env python下一行即可）
pyrightconfig.json 里该配什么才不踩坑
项目根目录放 pyrightconfig.json 比 VS Code 设置更稳定，尤其多人协作时避免本地设置污染。重点配这三项：
-
"include"：显式声明要检查的目录，比如["src", "tests"]，不写就会扫整个项目（含venv、.git），拖慢响应且报一堆无关警告 -
"exclude"：排除干扰项，例如["**/migrations", "**/__pycache__", "**/node_modules"]，否则 Django 迁移文件或缓存文件会触发大量假错误 -
"reportGeneralTypeIssues"：设为"none"可屏蔽Cannot assign member "xxx"这类泛型赋值警告（常见于 dataclass 或 attrs 场景），避免刷屏干扰核心逻辑问题
别碰 typeCheckingMode 字段——它和 VS Code 设置冲突，以编辑器设置为准。
最常被忽略的是 python.defaultInterpreterPath 配错导致的“类型检查开了却没反应”，以及忘了加 from __future__ import annotations 导致类内补全大面积失效。这两处一错，剩下所有配置都白搭。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
