如何在Python项目中正确配置导入？解决Click CLI测试报错问题

项目目录结构如下：

.
├── AUTHORS.rst
├── CONTRIBUTING.rst
├── HISTORY.rst
├── MANIFEST.in
├── Makefile
├── README.rst
├── __pycache__
│   └── test.cpython-310.pyc
├── docs
├── logs
├── python_server_copy
│   ├── __init__.py
│   ├── cli.py
│   ├── copy.py
│   ├── python_server_copy.py
│   ├── test.py
│   └── utils.py
├── requirements_dev.txt
├── setup.cfg
├── setup.py
├── tests
└── tox.ini

这是一个基于click的命令行应用，包内文件使用绝对导入，例如copy.py中：

from python_server_copy.utils import get_project_root

但直接以脚本形式运行文件或测试时会出现ModuleNotFound错误，必须删除包名才能正常运行；而作为Click命令行应用运行时一切正常，使用Python 3.7.11。

1. 以可编辑模式安装本地包 #

在项目根目录（包含setup.py的目录）执行以下命令：

pip install -e .

此操作会将本地包注册到Python的site-packages中，后续无论在哪个路径运行代码，包内的绝对导入都能被正确识别，无需修改导入语句。

2. 手动将项目根目录加入Python路径 #

临时设置（终端环境） #

运行脚本或测试前，先设置环境变量：

# Linux/macOS
export PYTHONPATH=$(pwd):$PYTHONPATH

# Windows（命令提示符）
set PYTHONPATH=%cd%;%PYTHONPATH%

代码内自动设置 #

在测试文件或需要直接运行的脚本开头添加以下代码：

import sys
from pathlib import Path

# 定位项目根目录（包含python_server_copy文件夹的上级目录）
project_root = Path(__file__).resolve().parent.parent
sys.path.append(str(project_root))

这样运行时会自动将项目根目录加入Python路径，无需手动调整环境变量。

3. 使用pytest运行测试 #

直接在项目根目录执行：

pytest

pytest默认会将项目根目录加入Python路径，能自动识别包内的绝对导入，无需额外配置。

4. 以模块方式运行包内脚本 #

不要直接运行包内的.py文件，而是用模块方式启动：

python -m python_server_copy.copy

这种方式会让Python以包模块的形式加载代码，自动处理路径问题，导入语句无需修改。

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