如何在GitHub上高效管理Python模块，实现多项目复用与团队共享？

这问题我帮不少团队捋过，给你一套落地性强的方案，既能让你的模块只存一份，又能在多项目、Jupyter Notebook里轻松复用，团队成员也能无缝接入：

先把你的常用函数整理成标准Python包结构，这是复用的基础：

• 新建一个专门的文件夹（比如叫team_shared_utils，名字要见名知意）
• 把你的函数文件（比如common_funcs.py）放进去，同时在文件夹里加一个空的__init__.py文件（这是Python识别包的标志，也可以在里面提前导入常用函数，方便后续直接调用）
• 可选但推荐：加个requirements.txt，把模块依赖的第三方库（比如numpy、pandas）列出来；再写个setup.py或pyproject.toml，让包能被pip安装

举个目录结构例子：

team_shared_utils/
├── __init__.py       # 可空，也可以写from .common_funcs import *
├── common_funcs.py   # 你的所有常用函数都在这里
└── requirements.txt  # 比如写 numpy>=1.23.0 pandas>=1.5.0

方法1：开发模式安装（首推，改代码实时生效） #

在team_shared_utils文件夹的根目录下，运行：

pip install -e .

这个命令会把你的包“链接”到Python环境里，实际代码还是在本地文件夹，改完函数不用重新安装，所有本地项目、Notebook都能直接导入：

from team_shared_utils.common_funcs import data_clean, plot_trend

方法2：临时添加路径（快速测试用） #

如果不想安装包，在项目脚本或Notebook开头加这段代码，把模块路径加入Python的搜索路径：

import sys
from pathlib import Path

# 替换成你的team_shared_utils文件夹的绝对路径，或者相对路径（如果项目和模块位置固定）
utils_path = Path("/Users/yourname/projects/team_shared_utils")
sys.path.append(str(utils_path))

# 之后就能正常导入函数
from common_funcs import data_clean

注意：这个方法换环境或路径变动后需要修改代码，适合临时测试，长期复用还是推荐安装方式。

把这个team_shared_utils单独做成一个GitHub仓库，团队成员就能轻松复用：

1. 把模块仓库推送到GitHub（仓库名比如叫team-python-shared-utils）
2. 团队成员可以直接通过pip安装这个远程仓库的包：

pip install git+https://github.com/your-team/team-python-shared-utils.git

如果需要一起迭代模块，成员可以克隆仓库后，用pip install -e .安装开发版本，改完代码推送到GitHub，其他人拉取更新后就能用新功能。

不管是本地还是团队成员的Notebook，只要按上面的方法安装了包，直接导入就行：

from team_shared_utils.common_funcs import data_clean, plot_trend

如果是临时用未安装的模块，也可以用路径添加法，但建议团队统一用安装方式，避免每个人路径不一致导致报错。另外，在Notebook的配套README里可以写清楚安装步骤，比如：

使用前请先安装共享工具包：

pip install git+https://github.com/your-team/team-python-shared-utils.git

之后在Notebook中导入即可使用。

• 给每个函数加文档字符串，比如说明参数、返回值和使用场景，团队用起来更顺畅
• 给模块仓库加个README.md，写清楚包的功能、安装方法和使用示例
• 迭代版本时给GitHub仓库打标签（比如v1.0.0），团队成员可以安装指定稳定版本：

pip install git+https://github.com/your-team/team-python-shared-utils.git@v1.0.0

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