VSCode中导入自定义search模块遇Pylance警告及导入问题求助

一、更换导入方式的几种可行方案 #

• 手动添加src到Python路径：在你运行的脚本开头加入以下代码，强制让Python识别src文件夹：

  import sys
  sys.path.append('./src')
  import search
  

• 使用相对导入：如果你的主脚本和src文件夹处于同级目录，可以尝试相对导入语法（注意：直接运行的主脚本用相对导入可能报错，建议把主脚本放到单独的文件夹，或者先把src标记为源码根目录）：

  from .src import search
  

• 直接导入模块文件：如果search是src文件夹里的search.py文件，也可以直接指定文件路径导入（应急可用，不推荐长期使用）：

  import importlib.util
  spec = importlib.util.spec_from_file_location("search", "./src/search.py")
  search = importlib.util.module_from_spec(spec)
  spec.loader.exec_module(search)
  

二、让Pylance正确识别src为源码目录 #

• 右键VSCode中的src文件夹，选择「将文件夹添加到Python路径」，Pylance会自动把它纳入源码扫描范围，解决模块识别问题。
• 手动修改VSCode的settings.json，添加src路径到分析路径：

  {
    "python.analysis.extraPaths": ["./src"],
    "python.pythonPath": "你的Python解释器绝对路径"
  }
  

三、处理“search is not accessed”警告 #

这个警告本质是Pylance检测到你导入了模块但没使用：

• 如果确实要使用模块，调用其中的函数/类，比如search.your_function()，警告会自动消失。
• 如果只是需要导入模块（比如注册钩子），可以加注释忽略警告：

  from src import search  # noqa: F401
  

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