如何让myprogram.py无需预配置环境即可使用venv依赖运行？

1. 调整项目结构（添加必要文件） #

将lib目录转为标准Python包（新增空文件lib/__init__.py），同时添加pyproject.toml和setup.cfg配置文件，最终结构如下：

your-repo/
├── myprogram.py
├── requirements.txt
├── pyproject.toml
├── setup.cfg
└── lib/
    ├── __init__.py
    ├── modulea.py
    └── moduleb.py

2. 配置项目安装文件 #

pyproject.toml #

指定构建工具为setuptools，让pip能正确处理项目：

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

setup.cfg #

定义项目元信息、依赖和包结构，实现自动安装依赖与模块路径识别：

[metadata]
name = myprogram
version = 0.1.0
description = Your program description

[options]
packages = find:
install_requires =
    -r requirements.txt
python_requires = >=3.6

[options.packages.find]
where = lib

3. 修改myprogram.py #

• 第一行设置标准shebang，确保系统能自动找到Python3：#!/usr/bin/env python3
• 使用绝对导入lib下的模块，避免硬编码路径：

#!/usr/bin/env python3

from lib.modulea import some_function_a
from lib.moduleb import some_function_b

def main():
    # 你的核心程序逻辑
    some_function_a()
    some_function_b()

if __name__ == "__main__":
    main()

4. 用户安装与运行流程 #

用户克隆仓库后，仅需执行标准安装命令：

pip install .

该命令会自动完成：

• 安装requirements.txt中的所有依赖
• 将lib包注册到Python的全局模块路径中

之后用户可通过以下方式运行程序：

• 直接执行：./myprogram.py（需先通过chmod +x myprogram.py添加执行权限）
• 使用绝对路径运行：/path/to/your-repo/myprogram.py
• 在文件管理器中双击myprogram.py（系统会通过shebang调用Python3执行）

关键优势 #

• 遵循Python生态标准：使用pip+setuptools的官方分发方式，无自制脚本
• 无环境依赖：无需手动配置venv或环境变量，只要系统安装Python3即可运行
• 无硬编码路径：通过包安装机制让Python自动识别模块，代码更健壮

内容的提问来源于stack exchange，提问作者Peter V. Mørch