Python添加自定义模块的两种核心方法详解

Python自定义模块添加概述

通常，为了便于维护，我们会将自行编写的Python模块与Python内置模块分开存放。那么，具体该如何在Python环境中添加并调用这些自定义模块呢？

核心概念：包与文件夹的区别

在探讨具体操作之前，需要明确两个关键概念：

第一，严格区分“包（package）”与“文件夹”。在Python中，包含__init__.py文件的文件夹才被视为包；若文件夹内没有__init__.py文件，则仅为普通文件夹。

第二，在编写模块导入语句时，必须注意仅指定包路径，而不要包含文件夹路径。

注册新类库的两种主要方法

Python运行环境在查找库文件时，会遍历sys.path列表。若希望在运行环境中注册新的类库路径，主要有以下两种实现方式：

方法一：在sys.path列表中添加新的路径。

方法二：将库文件直接复制到sys.path列表已包含的目录中（例如site-packages目录）。

查看sys.path路径配置

我们可以通过执行以下代码来查看当前的sys.path配置：

import sys
print sys.path

运行上述代码后，输出结果如下：

['/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/lib-old', '/System/Library/Frameworks/Python.

framework/Versions/2.7/lib/python2.7/lib-dynload', '/System/Library/Frameworks/Python.framework/Versions/2.7/Extras/

lib/python/PyObjC', '/Library/Python/2.7/site-packages']

在上述两种方法中，第一种方法操作相对简单，且对系统环境的影响最小。

方法一：使用.pth文件配置路径

接下来，我们详细介绍第一种方法的具体操作步骤：

在Python安装目录下的site-packages文件夹中，新建一个名为pythontab.pth的文件。假设site-package的路径为：/Library/Python/2.7/site-packages，该文件的内容应填写需要导入的package所在的文件夹路径。

这样，当Python在遍历已知的库文件目录过程中遇到.pth文件时，会将文件中记录的路径自动加入到sys.path设置中。此时，.pth文件所指向的package即可被Python运行环境顺利识别，从而可以像使用内置模块一样引入自定义模块。

方法二：动态添加sys.path

如果默认的sys.path中未包含自己模块或包的路径，也可以直接使用sys.path.append()方法动态添加包路径。

自定义模块添加原则总结

知识点扩展：

Python中添加自定义模块需遵循以下原则：

1. 严格区分包和文件夹。包的定义即为包含__init__.py的文件夹；若无__init__.py，则视为普通文件夹。

2. 导入package。在Python安装目录的site-packages文件夹中新建xxx.pth文件，其内容需指定需要导入的package所在的文件夹路径。

3. 导入模块。采用常规的模块导入写法，但需注意仅指定包路径，不要包含文件夹路径。

以上即为Python中添加自定义模块的详细内容，更多关于Python中自定义模块配置的资料，请关注本站其他相关文章！