为什么VSCode中pynput的mouse.position运行正常但不被识别且无自动补全？

核心原因：代码可正常运行但补全缺失，本质是pynput的mouse.Controller采用跨平台动态属性实现机制，主类未在静态类型定义中包含所有运行时才会加载的实例属性，Pylance基于静态规则做补全识别时，不会枚举运行时动态生成的属性，因此不会将position纳入自动补全列表。此前重装VS Code、Python、pip的操作无法解决这个问题，因为问题根源不在环境损坏，而在库本身的类型定义缺失。

可落地的解决方法 #

• 确认解释器匹配
  在VS Code状态栏右下角确认选中的Python解释器，和终端内执行pip show pynput返回的安装路径属于同一个环境。如果pynput安装在其他虚拟环境，哪怕代码能通过终端正常运行，VS Code的补全服务也无法定位到库文件。
• 安装社区维护的类型存根
  在当前选中的Python解释器对应的终端中执行命令安装存根：

  pip install types-pynput
  

  安装完成后按Ctrl+Shift+P调出命令面板，执行Python: Restart Language Server重启语言服务，Pylance就能自动加载完整的属性定义，将position纳入补全列表。
• 手动补充类型标注
  如果不想安装额外依赖，可以在初始化控制器时手动补充类型声明，让Pylance识别动态属性：

  from pynput.mouse import Button, Controller
  from typing import Tuple
  
  # 继承原Controller类，补充缺失的属性定义
  class TaggedController(Controller):
      position: Tuple[int, int]
  
  mouse = TaggedController()
  

  完成标注后，输入mouse.时补全列表就会正常加载position属性。
• 调整Pylance校验严格度
  打开VS Code设置，搜索python.analysis.typeCheckingMode，将默认的basic模式调整为off或minimal，Pylance会降低静态类型校验的严格程度，自动识别类上挂载的动态属性并纳入补全范围。

内容的提问来源于stack exchange，提问作者Deep Dreams