Python无法定位本地模块：导入tools报No module named 'tools' 求助

1. 核对项目结构与导入语法 #

先确认你的项目目录结构是否符合Python包的要求，正确结构示例：

项目根目录/
├── venv/
└── tools/
    ├── __init__.py
    └── tools.py  # 包含get_profile_url函数

如果从项目根目录运行脚本，导入代码需写成：
from tools.tools import get_profile_url
若脚本存放在子文件夹中，需调整导入路径，或手动将项目根目录加入Python的搜索路径。

2. 确认虚拟环境已激活 #

• Windows系统：在终端执行 venv\Scripts\activate
• macOS/Linux系统：在终端执行 source venv/bin/activate
  激活成功后终端会显示(venv)前缀，此时运行脚本才会使用虚拟环境内的Python解释器。

3. 同步VSCode的Python解释器配置 #

VSCode可能未选中venv的解释器，操作步骤：

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）
• 输入Python: Select Interpreter，选择venv文件夹下的Python解释器（如./venv/bin/python或./venv/Scripts/python.exe）

4. 确保__init__.py文件存在 #

tools文件夹必须包含空的__init__.py文件，Python才会将其识别为可导入的包。若没有，直接在tools文件夹内创建一个空的__init__.py文件即可。

5. 手动添加项目根目录到Python路径 #

若以上方法无效，可在脚本开头添加以下代码，强制将项目根目录加入Python搜索路径：

import sys
from pathlib import Path

# 假设脚本存放在项目根目录下，获取根目录路径
project_root = Path(__file__).parent
sys.path.append(str(project_root))

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