如何在Visual Studio中解决Python项目本地依赖库导入失败问题

先检查文件夹结构 #

• 目标包所在的文件夹必须有__init__.py文件（Python 3.3+虽支持无此文件的命名空间包，但加这个文件能避免大部分识别问题）。正确结构参考：

  X/
    你的包名/
      __init__.py
      模块1.py
      模块2.py
  

• 要是想直接导入X文件夹本身，那X里也得放__init__.py，不然Python不会把它识别为可导入的包。

手动给Python加搜索路径 #

IDE的Search Path偶尔会失效，直接在代码里加路径最稳妥：

import sys
import os
# 把X的绝对路径添加到Python搜索列表
sys.path.append(os.path.abspath("你本地X文件夹的绝对路径"))
# 之后再尝试导入
import 你的包名

记得把路径换成你电脑上X的实际路径，比如C:\Projects\X或者/home/user/X。

确认路径真的被加入了 #

先运行这段代码，查看Python当前的搜索路径列表里有没有X：

import sys
print(sys.path)

要是找不到X的路径，说明之前的IDE设置没生效，用上面手动加路径的方法肯定能解决。

检查虚拟环境（如果用了的话） #

• 如果你开了虚拟环境，先确认IDE是不是切换到了对应的环境，Search Path的设置可能只对当前激活的环境生效。
• 可以在终端激活虚拟环境后，输入python -c "import sys; print(sys.path)"，和IDE里的输出对比，看看路径是否一致。

直接把本地包装到环境里（可选） #

要是上面的方法都不管用，用pip的 editable模式安装本地包：

pip install -e 你本地X文件夹的绝对路径

这样会在环境的site-packages里创建一个链接，Python能直接识别到包，而且你修改X里的代码会实时生效，适合开发场景。

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