Pylance提示import mysql.connector无法解析 工作目录模式下导入报错

问题现象 #

• 单文件打开/mnt/c/Users/icelu/Downloads/Codes/Github/My-hw-codes/myTest.py时，import mysql.connector识别正常，代码运行无异常
• 以My-hw-codes为根目录打开整个工作区时，Pylance抛出import mysql.connector could not be resolved报错
• 复现代码如下：

import mysql.connector


mydb = mysql.connector.connect(
  host="localhost",
  user="yourusername",
  password="yourpassword"
)

cursor = mydb.cursor()
print(mydb)

核心原因 #

单文件模式下Pylance默认继承当前终端激活的全局Python环境路径；打开工作区时，Pylance会优先读取工作区绑定的Python解释器配置，二者环境不一致时就会出现「代码能跑但静态检查报找不到包」的问题。你当前项目路径是WSL挂载的Windows磁盘路径，大概率是打开工作区时VSCode自动切换到了Windows本地Python解释器，而mysql-connector-python是安装在WSL的Python环境里的，两边环境隔离导致识别失败。

修复步骤 #

1. 统一工作区Python解释器
   按Ctrl+Shift+P调出命令面板，执行Python: Select Interpreter，在列表里选中你安装了mysql依赖的那个解释器（WSL环境下会标注WSL: Ubuntu之类的后缀，不要选Windows路径下的python.exe）。
2. 解释器选对后仍报错则手动补全Pylance搜索路径
   在工作区根目录新建.vscode/settings.json文件，添加如下配置，把对应Python环境的第三方包路径加入Pylance的搜索范围：

   {
       "python.analysis.extraPaths": [
           // 可在对应Python环境中执行以下命令获取准确的site-packages路径：
           // python -c "import site; print(site.getsitepackages()[0])"
           "/usr/local/lib/python3.10/dist-packages"
       ]
   }
   

3. 重启语言服务生效
   再次调出命令面板，执行Pylance: Restart Language Server，等待索引完成后报错就会消失。

避坑提示 #

• 不要在项目根目录下创建和第三方包同名的文件/文件夹，比如不要建mysql.py或者名为mysql的目录，会覆盖Pylance的导入搜索优先级
• 如果用了虚拟环境，选解释器的时候要选中虚拟环境目录下的Python二进制文件，不要选全局环境

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