Python 中模块与包：基础概念与使用详解

模块与包在 Python 编程中起着至关重要的作用，合理运用它们可以让代码结构更加清晰、易于维护和复用。通过掌握模块的导入方式、搜索顺序以及__name__属性的使用，还有包的组织、文件的编写以及调用方法，开发者能够更好地管理项目中的代码，提升 Python 编程的效率和质量。无论是小型项目还是大型工程，对模块与包的熟练运用都是写出优质 Python 代码的必备技能。

Python智慧行囊

973人浏览 · 2025-04-10 15:40:12

Python智慧行囊 · 2025-04-10 15:40:12 发布

在 Python 编程世界里，模块与包是组织代码、实现代码复用以及管理项目结构的重要概念。合理运用模块与包，不仅能让代码更加整洁有序，还能提高开发效率。本文将深入探讨 Python 中模块与包的相关知识。

一、模块

（一）模块的概念

定义：以.py为扩展名的 Python 源码文件都是一个模块。简单来说，每一个.py文件就像是一个独立的代码单元，里面可以包含变量、函数、类等各种 Python 元素。
命名规则：模块名是一个标识符，需遵循标识符的命名规则。即只能由字母、数字和下划线组成，且不能以数字开头，同时应尽量做到见名知意，方便理解和使用。
功能：模块中定义的全局变量、函数、类等，都是可供外界使用的工具。可以把模块看作是一个工具包，里面封装了各种能完成特定功能的代码片段，其他代码文件可以通过导入模块来使用这些工具。

（二）模块的导入方式

1、import 导入

语法规范：在导入模块时，每个导入应该单独占一行，这样代码结构更加清晰。例如：

import module1
import module2

使用方法：通过 “模块名.” 的方式来使用模块提供的工具。假设module1中有一个函数func1，那么使用时就是module1.func1() 。
别名设置：如果模块的名字太长，为了方便使用，可以使用as给模块起别名，且模块别名建议符合大驼峰命名法。比如import veryLongModuleName as VLMN ，后续使用VLMN.func() （假设模块中有func函数）。

2、from...import 导入

部分导入：可以从一个模块中导入部分工具。例如from module1 import func1 ，这样在代码中就可以直接使用func1() ，而不需要通过模块名来调用。
全部导入：from...import * 这种方式是从模块中导入所有工具。不过在实际使用中要谨慎，因为如果导入多个模块都使用这种方式且模块间有同名函数等情况，后导入的模块会覆盖先导入的模块，可能导致代码出现意外行为。
优点：不需要通过模块名。调用，可以直接使用模块提供的工具，代码书写相对简洁。

（三）模块的搜索顺序

Python 解释器在导入模块时，会按照特定顺序进行搜索：

首先搜索当前目录下指定模块名的文件，如果存在就直接导入。这意味着如果我们自己编写了与要导入模块同名的文件在当前工作目录，就会优先导入这个自定义文件。
如果当前目录没有找到，再搜索系统目录。系统目录包含了 Python 安装时自带的标准库等模块所在位置。

（四）name属性

__name__是 Python 的一个内置属性，它记录着一个字符串。

如果当前模块是被其他文件导入的，__name__就是模块名。
如果当前模块是正在执行的程序，__name__ 是__main__ 。利用这个特性，我们可以在模块中编写测试代码，让其只在测试情况下（即模块作为主程序运行时）被执行，而在被其他模块导入时不会被执行。例如：

def test_function():
    print("This is a test function")

if __name__ == "__main__":
    test_function()

这样，当该模块被其他文件导入时，test_function() 不会被调用，只有直接运行这个模块文件时才会执行。

二、包

（一）包的概念

定义：包是一个包含多个模块的特殊目录。它就像是一个更大的容器，把相关的模块组织在一起，方便管理和使用。
特殊文件：包目录下必须有一个特殊的文件__init__.py ，早期这个文件可以为空，但在一些新的 Python 应用场景中，它可以用来进行包的初始化操作，比如导入包内的模块等。
命名规则：包名的命名方式和变量名一致，采用小写字母和下划线组合的方式，这样符合 Python 代码的规范和可读性要求。

（二）包的导入与使用

1、创建包结构

假设我们有一个名为my_package 的包，其目录结构如下：

my_package/
    __init__.py
    module1.py
    module2.py

在module1.py 中定义一个函数func1 ：

def func1():
    print("This is func1 in module1")

在module2.py 中定义一个函数func2 ：

def func2():
    print("This is func2 in module2")

`2、init.py`文件的编写

简单导入所有模块：如果想在导入包时，能直接使用包内模块的函数等，可以在__init__.py 中导入包内的模块。例如：

from. import module1
from. import module2

这里的. 表示当前包的路径。这样导入后，在其他文件中导入my_package 包后，就可以通过my_package.module1.func1() 和my_package.module2.func2() 来调用函数。

有选择地导入模块中的函数或类：如果只想暴露包内模块的部分函数或类，可以在__init__.py 中这样写：

from.module1 import func1
from.module2 import func2

此时，在其他文件中导入my_package 包后，可以直接使用my_package.func1() 和my_package.func2() ，无需再指定模块名。

3、导入包并调用

在另一个 Python 文件（假设叫main.py ）中导入包并调用函数：

import my_package

my_package.module1.func1()  # 如果__init__.py是简单导入所有模块的方式
my_package.func2()  # 如果__init__.py是有选择地导入函数的方式

或者使用from...import 方式导入：

from my_package import module1
from my_package import func2

module1.func1()
func2()

三、总结

模块与包在 Python 编程中起着至关重要的作用，合理运用它们可以让代码结构更加清晰、易于维护和复用。通过掌握模块的导入方式、搜索顺序以及__name__属性的使用，还有包的组织、__init__.py文件的编写以及调用方法，开发者能够更好地管理项目中的代码，提升 Python 编程的效率和质量。无论是小型项目还是大型工程，对模块与包的熟练运用都是写出优质 Python 代码的必备技能。

天启AI社区

GitCode 天启AI是一款由 GitCode 团队打造的智能助手，基于先进的LLM（大语言模型）与多智能体 Agent 技术构建，致力于为用户提供高效、智能、多模态的创作与开发支持。它不仅支持自然语言对话，还具备处理文件、生成 PPT、撰写分析报告、开发 Web 应用等多项能力，真正做到“一句话，让 Al帮你完成复杂任务”。

更多推荐