Python 添加自定义模块导入路径的三种方法

Python 添加模块导入路径概述

在 Python 开发中，若需导入非标准库路径下的模块，主要有以下三种实现方式：

方法一：使用 sys.path.append() 动态添加

第一种方法是通过 sys.path.append() 动态添加路径。该方法在程序运行期间有效，一旦程序执行结束，所添加的路径便会立即失效，属于临时性解决方案。

import sys
sys.path.append('自定义路径')

方法二：配置 PYTHONPATH 环境变量

第二种方法是将路径添加到环境变量 PYTHONPATH 中，这种方式可以针对当前用户或所有用户进行配置。

对于当前用户的配置，需要编辑用户主目录下的 .bashrc 隐藏文件。

sudo vim ~/.bashrc

若只需添加单个自定义路径，可在配置文件中写入相应的导出语句。

export PYTHONPATH=<自定义路径>:$PYTHONPATH

若需添加多个路径，只需使用冒号 ':' 将各个路径分隔开，并追加到现有的 PYTHONPATH 变量后。

export PYTHONPATH=<自定义路径1>:<自定义路径2>:...:$PYTHONPATH

保存文件后，在终端执行 source 命令可使环境变量立即生效，无需重启终端。

source ~/.bashrc

若需为系统中所有用户生效，则需要操作全局配置文件 /etc/profile。

sudo vim /etc/profile

在全局配置文件中，添加单个路径的方法与用户配置类似。

export PYTHONPATH=<自定义路径>:$PYTHONPATH

同样地，若需添加多个路径，使用冒号分隔即可。

export PYTHONPATH=<自定义路径1>:<自定义路径2>:...:$PYTHONPATH

修改完成后，在终端执行 source 命令使全局配置生效。

source /etc/profile

方法三：使用 .pth 文件持久化路径

第三种方法是使用 .pth 文件，这是 Python 官方推荐的一种持久化路径配置方式。

• 在已知的库文件目录 site-packages 中创建 .pth 文件，并在文件中按行写入自定义路径。
• 例如，在 /usr/local/python3/lib/python3.9/site-packages 目录下创建名为 python.pth 的文件（具体路径需根据个人 Python 安装环境调整）。

sudo vim /usr/local/python3/lib/python3.9/site-packages/python.pth

在 python.pth 文件中，每行写入一个自定义路径。

/.../自定义路径1
/.../自定义路径2
...

Python 在初始化时遍历已知的库文件目录，若遇到 .pth 文件，会自动将文件中记录的路径加入 sys.path。这样，.pth 文件所指明的路径即可被 Python 运行环境识别并导入。

以上即为在 Python 中添加模块导入路径的三种主要方法。更多相关技术细节可参考本站其他文章或继续浏览后续内容，感谢支持！