本地与Kubernetes环境Python导入路径兼容问题求助

问题根源 #

本地Windows+PyCharm环境与Kubernetes Pod的Python模块搜索路径（sys.path）不一致：Kubernetes环境中项目根目录已被加入sys.path，因此from client.utils import ...能正常解析；而本地环境未正确配置，导致Python无法找到对应模块。

无需修改代码的兼容方案 #

1. 配置PyCharm源码根目录 #

• 找到项目根目录下的client文件夹，右键点击 → Mark Directory as → Sources Root。
• 此操作会让PyCharm自动将该目录加入Python模块搜索路径，与Kubernetes环境保持一致。

2. 设置PYTHONPATH环境变量 #

方式一：PyCharm运行配置中临时设置

• 打开Run/Debug Configurations，选择你要运行的脚本/服务。
• 在Environment Variables区域，点击添加按钮，新增变量PYTHONPATH，值设为项目根目录的绝对路径（例如C:\Users\YourName\Projects\amir-without-models）。

方式二：Windows全局环境变量设置

• 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量。
• 点击「新建」系统变量，变量名填PYTHONPATH，变量值填项目根目录的绝对路径。

3. 启动脚本自动调整sys.path #

在项目根目录的启动脚本（如main.py）开头添加以下代码，强制将项目根目录加入sys.path：

import sys
from pathlib import Path

# 获取项目根目录路径
project_root = Path(__file__).resolve().parent
# 确保根目录在搜索路径最前面
if str(project_root) not in sys.path:
    sys.path.insert(0, str(project_root))

此方法不依赖IDE配置，本地和Kubernetes环境均可自动适配。

4. 调整单元测试配置 #

• 打开PyCharm的单元测试配置（Run/Debug Configurations → Tests）。
• 确认Working directory设置为项目根目录，或在Environment Variables中添加PYTHONPATH指向项目根目录。

内容的提问来源于stack exchange，提问作者or.cohenadiv