### 解决 Python 安装 `src` 模块或包的问题 当遇到无法安装或导入位于父级目录中的模块时，通常是因为 Python 的模块查找路径未包含该目录。以下是几种可能的解决方案： #### 方法一：调整 `PYTHONPATH` 可以通过设置环境变量 `PYTHONPATH` 来扩展 Python 查找模块的路径。这允许 Python 在指定的额外目录中寻找模块。 ```bash export PYTHONPATH="${PYTHONPATH}:/path/to/parent/directory" ``` 此命令会将 `/path/to/parent/directory` 添加到模块搜索路径中[^1]。如果是在 Windows 上，则可以使用以下方式设置环境变量： ```cmd set PYTHONPATH=%PYTHONPATH%;C:\path\to\parent\directory ``` #### 方法二：修改 `sys.path` 可以在脚本运行期间动态地向 `sys.path` 中添加所需的父级目录路径。这样可以让当前脚本能访问更高层次的模块。 ```python import sys import os current_dir = os.path.dirname(os.path.abspath(__file__)) parent_dir = os.path.join(current_dir, '..') sys.path.append(parent_dir) # 此处可正常导入 src 下的模块 from src.module_name import function_or_class ``` 这种方法适用于临时性的需求，在程序退出后不会保留更改。 #### 方法三：创建 `.pth` 文件 `.pth` 文件是一种机制，用于永久性地向 `sys.path` 增加新的路径。只需在一个已知被加载的位置（通常是 site-packages 目录下）放置一个文件名以 `.pth` 结尾的文本文件，并写入要加入的路径即可。 例如，在 Linux 或 macOS 系统上执行如下操作： ```bash echo "/path/to/parent/directory" | sudo tee /usr/local/lib/python3.x/site-packages/custom_paths.pth ``` 对于 Windows 用户来说，找到对应的 site-packages 路径并手动编辑类似的 `.pth` 文件[^2]。 #### 方法四：通过 pip 进行本地安装 如果项目结构复杂或者希望更正式化管理依赖关系，推荐利用 setuptools 工具打包整个应用并将源码作为独立软件分发给其他开发者甚至部署至生产环境中去使用它。具体步骤包括但不限于准备 setup.py 配置文件以及调用相应命令完成构建过程等等[^4]。 ```python from setuptools import find_packages, setup setup( name='your_project', version='0.1', packages=find_packages(), ) ``` 之后就可以像平常那样借助 pip 实现自动化处理流程了: ```bash pip install . ``` 以上就是针对 “Python cannot install src module or package”的一些常见解决办法总结[^2][^3].