Python模块路径处理最佳实践：简化函数路径传参方案问询

一、核心思路：让共享模块自主管理路径 #

不再依赖调用方传递路径，而是让Shared_Modules/shared.py通过自身文件位置定位项目根目录（Model），所有共享函数直接使用统一的基础路径。

步骤1：修改shared.py，内置固定路径 #

import os
import pandas as pd

# 获取当前模块文件的绝对路径（即Shared_Modules/shared.py的路径）
module_abspath = os.path.abspath(__file__)
# 向上回溯一级，得到项目根目录Model
root_path = os.path.dirname(os.path.dirname(module_abspath))
# 预定义业务文件的完整路径
INPUT_FILE_PATH = os.path.join(root_path, "data", "Sales_and_Input_Files", "model_input_file.xlsx")

def get_input_data(model_name):
    # 直接使用预定义路径，无需接收input_path参数
    config = pd.read_excel(INPUT_FILE_PATH, sheet_name='config', engine='openpyxl')
    return config

步骤2：简化main.py的模块导入 #

替换原有的路径拼接代码，用更可靠的方式导入共享模块：

import sys
from pathlib import Path

# 获取main.py所在目录的父目录（即Model根目录）
root_dir = Path(__file__).parent.parent
# 将根目录加入Python搜索路径
sys.path.append(str(root_dir))

from Shared_Modules import shared as sm

# 调用函数时无需传递路径
config = sm.get_input_data("your_model_name")

二、进阶优化：全局配置Python路径（Linux环境） #

如果不想在代码中重复处理sys.path，可以将项目根目录加入系统PYTHONPATH环境变量：

1. 临时生效（当前终端会话）：

export PYTHONPATH="/你的Model目录绝对路径:$PYTHONPATH"

2. 永久生效（写入shell配置文件）：
   编辑~/.bashrc或~/.zshrc，添加上述export命令，执行source ~/.bashrc使配置生效。

之后main.py可直接导入模块，无需处理路径：

from Shared_Modules import shared as sm

三、长期维护方案：将项目转为可安装包 #

若项目需要长期迭代，建议将Model目录封装为可安装的Python包：

1. 在Model目录下创建pyproject.toml文件：

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

[project]
name = "sales-segment-model"
version = "0.1.0"
packages = ["Shared_Modules"]

2. 以开发模式安装包：

cd /你的Model目录绝对路径
pip install -e .

安装完成后，任意位置的代码都可直接导入Shared_Modules.shared，路径管理仍采用shared.py中的__file__方案。

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