Linux虚拟环境Python相对导入失效：与Windows差异及解决方法

问题根源 #

Windows与Linux的Python虚拟环境路径处理逻辑存在差异：Windows下虚拟环境可能默认将project_venv目录加入了sys.path，但Linux无此默认行为；直接运行source目录下的脚本时，脚本会被视为顶层执行文件，无法使用相对导入访问上级目录的模块。

可行解决方案 #

方案1：通过虚拟环境的.pth文件永久添加路径 #

• 找到虚拟环境路径：Project/project_venv/lib/pythonX.X/site-packages（X.X为你的Python版本号，比如3.9）
• 在该目录下新建project_paths.pth文件，写入project_venv目录的绝对路径，例如：

  /home/your_username/Project/project_venv
  

• 重启Python解释器后，sys.path会自动包含该路径，直接用import defs as d即可正常导入，不受autopep8影响。

方案2：动态添加路径并规避autopep8调整 #

• 在source目录下脚本的最开头添加以下代码（用注释锁定顺序，避免autopep8打乱）：

  # autopep8: off
  import sys
  from pathlib import Path
  # 动态获取project_venv的绝对路径，无需硬编码
  sys.path.append(str(Path(__file__).parent.parent / "project_venv"))
  # autopep8: on
  
  import defs as d
  

• 这段代码通过Path模块自动定位上级目录，适配不同环境的路径结构，同时autopep8: off/on会让格式化工具跳过这段代码的顺序调整。

方案3：调整项目结构（更符合Python规范） #

• 将defs.py从project_venv目录迁移到独立的工具目录，比如新建utils目录，调整后的结构：

  Project
  |.vscode
  |project_venv
  |utils
  ||defs.py
  |source
  ||[依赖脚本]
  |typings
  

• 之后在source的脚本中使用相对导入，同时以模块方式运行脚本（避免顶层执行的限制）：

  from ..utils import defs as d
  

• 运行脚本时使用命令：python -m source.your_script_name（需确保当前工作目录在Project下）

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