如何在Mac/Linux设备上跨目录导入Python函数无需修改导入路径

方案1：动态计算路径（零配置，开箱即用） #

该方案不需要用户做任何额外操作，只要保持项目目录结构不变，直接执行python file_2.py即可正常运行，适配所有Mac/Linux系统。
在file_2.py开头替换原来的硬编码路径导入逻辑为以下代码：

import sys
from pathlib import Path

# 获取当前测试文件的绝对路径
current_file = Path(__file__).resolve()
# 向上溯源3级父目录拿到项目根目录（application）
project_root = current_file.parent.parent.parent
# 把file_1所在目录加入Python导入搜索路径
sys.path.append(str(project_root / "app" / "folder"))

from file_1 import *

同时你测试代码里的测试样本路径也建议改成动态绝对路径，避免用户在其他目录执行测试文件时找不到资源：

# 替换原来的NAME_FILE_1定义
current_dir = Path(__file__).resolve().parent
NAME_FILE_1 = str(current_dir / "test_sample.vcf")

方案2：打包为标准Python包（适合正式交付场景） #

如果需要长期给客户交付使用，推荐把项目做成标准可安装包，彻底规避路径导入问题，操作如下：

1. 在所有需要导入的目录下添加空的__init__.py文件，修改后的目录结构参考：

VCF_matcher
 ├── __init__.py
 ├── app
 │   ├── __init__.py
 │   └── run.py
 └── app2
     ├── __init__.py
     └── some_folder
         ├── __init__.py
         └── file_2.py

2. 在项目根目录（VCF_matcher的同级目录）添加pyproject.toml配置文件：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "VCF_matcher"
version = "0.1.0"
packages = ["VCF_matcher", "VCF_matcher.app", "VCF_matcher.app2"]

3. 用户首次使用时，只需在项目根目录执行一次pip install .，之后就可以任意位置直接运行测试文件，你原来写的from VCF_matcher.app.run import *导入逻辑无需修改即可生效。

优化建议 #

• 尽量避免使用from xxx import *的通配符导入方式，显式声明需要导入的函数，比如from VCF_matcher.app.run import load_sample，可减少命名冲突风险。
• 所有项目内资源引用都建议使用基于__file__动态计算的绝对路径，避免执行位置变化导致的文件找不到问题。

内容的提问来源于stack exchange，提问作者Manolo Dominguez Becerra