Python结构化项目终端运行f1.py提示找不到模块B.myfunc怎么办

这个问题我之前也踩过坑！核心原因是PyCharm和终端的**Python模块搜索路径（sys.path）**不一致：PyCharm默认会把你打开的项目根目录自动添加到sys.path里，所以能找到B模块，但终端里默认不会包含这个路径，就会抛出No module named 'B'的错误。

先明确下你的项目结构（方便对应操作）：

你的项目根目录/
├── A/
│   └── f1.py
├── B/
│   └── f2.py
└── C/
    └── f3.py

方法一：临时设置PYTHONPATH环境变量（快速临时解决） #

这个方法适合临时测试，关闭终端后设置会失效：

Linux/macOS终端操作： #

1. 先cd到你的项目根目录：

   cd /path/to/你的项目根目录
   

2. 设置PYTHONPATH为当前目录：

   export PYTHONPATH=$(pwd)
   

3. 运行f1.py：

   python A/f1.py
   

Windows CMD操作： #

1. 切换到项目根目录：

   cd C:\path\to\你的项目根目录
   

2. 设置PYTHONPATH：

   set PYTHONPATH=%cd%
   

3. 运行脚本：

   python A\f1.py
   

Windows PowerShell操作： #

1. 进入项目根目录：

   cd C:\path\to\你的项目根目录
   

2. 设置环境变量：

   $env:PYTHONPATH = Get-Location
   

3. 执行脚本：

   python A\f1.py
   

方法二：在代码中手动添加项目根目录到sys.path（永久生效，适合单个脚本） #

如果不想每次都设置环境变量，可以在f1.py的最顶部添加一段代码，自动把项目根目录加入到模块搜索路径中：

import sys
from pathlib import Path

# 获取项目根目录：f1.py在A目录，所以父目录的父目录就是项目根
project_root = Path(__file__).parent.parent
sys.path.append(str(project_root))

# 现在就可以正常导入了
from B.f2 import myfunc

# 你的其他代码...

这种方法用了pathlib来动态获取路径，不管你把项目移到哪个位置，代码都能正常工作，不会因为硬编码绝对路径出问题。

方法三：把项目转为可安装的Python包（推荐长期项目使用） #

如果这是一个长期维护的项目，最好把它变成一个标准的Python包，这样不管在哪都能正常导入模块：

1. 在项目根目录下创建setup.py文件（或者用更现代的pyproject.toml，这里先给setup.py的示例）：

from setuptools import setup, find_packages

setup(
    name="your-project-name",  # 替换成你的项目名称
    version="0.1.0",
    packages=find_packages(),  # 自动识别所有包含__init__.py的目录作为包
)

注：如果你的A、B、C目录里还没有__init__.py，可以创建空的__init__.py文件，这样find_packages()就能识别它们了。

2. 在终端cd到项目根目录，执行开发模式安装：

pip install -e .

这个命令会把你的项目以“可编辑模式”安装到Python环境中，之后不管你在终端的哪个位置，都能直接导入B.f2里的函数，而且修改代码后不需要重新安装，非常适合开发阶段使用。

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