如何让PyLance识别Docker容器或本地未安装的Python依赖并补全？

关联Docker容器的Python解释器 #

• 打开VS Code命令面板（Cmd+Shift+P），输入Python: Select Interpreter
• 选择Enter interpreter path，直接输入Docker容器内Python解释器的绝对路径。如果用Docker Compose，也可以通过VS Code的Docker扩展找到目标容器，一键关联它的Python环境
• 关联完成后，PyLance会自动读取容器内site-packages目录下的依赖，自动补全、语法检查功能即可正常使用

生成依赖的类型提示文件 #

• 若不想直接关联Docker环境，可在容器内运行pip install types-<package-name>（针对有官方类型提示的包），或使用stubgen工具生成自定义包的.pyi类型提示文件
• 将生成的.pyi文件拷贝到本地项目目录，PyLance会自动识别这些文件，提供基础的补全支持

本地虚拟环境映射容器依赖 #

• 在本地创建虚拟环境，通过docker cp命令将容器内的site-packages目录复制到本地虚拟环境对应的路径中
• 配置VS Code使用该本地虚拟环境作为解释器，PyLance就能读取到复制过来的依赖

处理仅克隆的Git仓库包 #

• 将克隆的Git仓库根目录添加到VS Code的python.analysis.extraPaths配置：
  1. 打开VS Code设置（Cmd+,）
  2. 搜索Python > Analysis: Extra Paths
  3. 添加仓库的绝对路径
• 配置完成后，PyLance会将该目录纳入Python包搜索路径，自动识别其中的模块、类并提供补全功能

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