远程调用测试文件时导入上级目录类文件失败求助

这个问题我之前部署测试脚本的时候也踩过坑！核心问题在于本地和远程环境的工作目录不一致，你用sys.path.append("../")添加的相对路径，在远程服务器上指向的并不是你的项目根目录，所以Python找不到ClassFolder.bla模块。

下面给你几个靠谱的解决方法，按推荐程度排序：

方法1：用动态绝对路径定位项目根目录（最灵活，无需额外配置） #

直接在test_bla.py里通过当前文件的路径动态计算项目根，不管在哪运行都能正确找到模块：

import sys
import os
import unittest

# 获取当前测试文件的绝对路径
current_test_file = os.path.abspath(__file__)
# 拿到TestFolder的目录
test_folder = os.path.dirname(current_test_file)
# 往上跳一级就是项目根目录
project_root = os.path.dirname(test_folder)
# 把项目根加入Python的模块搜索路径
sys.path.append(project_root)

from ClassFolder.bla import bla

这种方法完全不依赖运行时的工作目录，本地和远程环境通用。

方法2：设置PYTHONPATH环境变量（规范且持久） #

把你的项目根目录添加到系统的PYTHONPATH环境变量里，这样Python会自动在这个路径下搜索模块，不需要在脚本里手动改sys.path。

临时设置（单次运行有效） #

• Linux/macOS终端：

export PYTHONPATH=/绝对路径/to/project_name:$PYTHONPATH
python TestFolder/test_bla.py

• Windows命令提示符：

set PYTHONPATH=C:\绝对路径\to\project_name;%PYTHONPATH%
python TestFolder\test_bla.py

永久设置（每次登录都生效） #

• Linux/macOS：把上面的export命令加到~/.bashrc或~/.zshrc里；
• Windows：在系统环境变量里添加PYTHONPATH，值设为你的项目根目录。

设置好之后，test_bla.py里直接写正常的导入语句就行：

import unittest
from ClassFolder.bla import bla

方法3：将项目转为可安装的Python包（适合长期维护的项目） #

如果你的项目需要长期迭代，推荐把它做成标准的Python包，这样不管本地还是远程，安装后就能直接导入模块。

1. 在project_name目录下创建setup.py文件：

from setuptools import setup, find_packages

setup(
    name="project_name",
    version="0.1.0",
    packages=find_packages(),
)

2. 用pip安装成可编辑模式（修改代码后无需重新安装）：

cd /path/to/project_name
pip install -e .

之后不管在哪运行测试，test_bla.py里都可以直接导入：

import unittest
from ClassFolder.bla import bla

额外提醒 #

远程运行时一定要确认：你有没有权限访问项目目录？路径里有没有大小写错误？（Linux系统是区分大小写的，Windows不区分，这也可能导致本地正常远程报错）

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