Python 添加模块路径的三种方法总结

宋时安

发布时间：2026-10-13| 6人浏览过

原创

本文总结了在 Python 中添加自定义模块路径的三种常用方法。包括通过设置 PYTHONPATH 环境变量、在 site-packages 目录下创建 .pth 配置文件，以及使用 sys.path.append() 函数动态添加路径。文章还指出了在特定环境下部分方法的局限性，为开发者解决模块导入问题提供实用参考。

此前对 macOS 系统自带的 Python 版本进行了升级，升级后发现新安装的 Python 的 site-packages 目录未被自动加入系统路径。这导致在使用某些第三方库时，经常遇到缺少模块的错误提示。

查看当前 Python 模块搜索路径的方法如下：

import sys print(sys.path)

执行上述代码即可打印出当前所有的模块搜索路径列表。

以下介绍在 Python 系统路径中手动添加新模块路径的三种具体方法：

第一种方法是添加环境变量 PYTHONPATH。Python 会自动识别并添加此环境变量所指路径下的模块。具体操作是在 .bash_profile 文件中添加类似如下的一行配置：

export PYTHONPATH=$PYTHONPATH:/usr/local/lib/python2.7/site-packages

第二种方法是在 site-packages 路径下添加一个路径配置文件。该文件的扩展名必须为 .pth，文件内容只需包含想要添加的模块路径即可。

第三种方法是使用 sys.path.append() 函数来添加搜索路径，其参数值即为需要添加的具体路径字符串。

需要注意的是，上述第二种方法存在前提条件：如果 Python 环境本身尚未正确识别 site-packages 目录，那么第二种方法可能无法生效。

以上关于 Python 添加模块路径的三种方法总结就是本文的全部内容，希望能对大家有所帮助。欢迎大家参考并支持本站。