模块是 Python 代码组织的基础单位，也是实现代码复用、项目管理的关键工具。本篇从模块概述、自定义模块、导入方式三个维度，用最通俗的语言+全新示例，带你轻松掌握模块的核心概念。
1. 模块概述
1.1 什么是模块
模块就是一个 Python 文件（.py），包含函数、类、变量等定义。
一个 .py 文件 = 一个模块
为什么需要模块？
在实际项目开发中，我们经常会遇到这些问题：
代码文件过大，难以管理和维护
功能代码分散在多个地方，查找困难
不同项目需要重复编写相同功能
函数名和变量名容易冲突
模块就是解决这些问题的最佳方案：
本质：将相关功能代码组织在一个 .py 文件中
核心：一次编写，多次导入，避免重复造轮子
1.2 模块的优点
| 优点 | 说明 |
|---|
| 提高可维护性 | 代码组织清晰，便于查找和维护 |
| 提高复用性 | 一个模块可以在多个项目中使用 |
| 避免命名冲突 | 不同模块中的函数名可以相同 |
| 便于分工 | 团队成员可以分别维护不同模块 |
1.3 模块的分类
Python 中的模块分为三种：
① 内置模块
Python 自带的模块，无需安装，直接导入使用。
# 常用内置模块
import os# 操作系统接口
import sys# 系统相关
import math# 数学函数
import random# 随机数
import time# 时间相关
import datetime# 日期时间
import json# JSON 处理
import re# 正则表达式
② 自定义模块
根据项目需求，自己编写的 .py 文件。
# 创建一个自定义模块：calculator.py
def add(a, b):
return a+b
def subtract(a, b):
return a-b
③ 第三方模块
别人写好的具有特殊功能的模块，需要通过 pip 安装。
# 常用第三方模块
import numpy# 数值计算
import pandas# 数据分析
import requestsn # HTTP 请求
import flask# Web 框架
1.4 封装思路
Python 代码组织遵循一个递进式的封装思路：
函数 => 类 => 模块 => 包 => 项目
逐级说明：
| 层级 | 说明 | 示例 |
|---|
| 函数 | 最小的功能单位 | def add(a, b) |
| 类 | 将相关函数和数据组织在一起 | class Calculator |
| 模块 | 将相关类和函数放在一个 .py 文件 | calculator.py |
| 包 | 将相关模块放在一个目录 | math_tools/ |
| 项目 | 完整的应用程序 | my_project/ |
2. 自定义模块
2.1 创建自定义模块
创建一个自定义模块非常简单，就是创建一个 .py 文件。
第一步：创建模块文件 calculator.py
# calculator.py - 这就是一个模块
# 定义变量
PI=3.14159
VERSION="1.0"
# 定义函数
def add(a, b):
"""计算两数之和"""
return a+b
def subtract(a, b):
"""计算两数之差"""
return a-b
def multiply(a, b):
"""计算两数之积"""
return a*b
def divide(a, b):
"""计算两数之商"""
if b==0:
return "错误：除数不能为0"
return a/b
# 定义类
class Calculator:
def __init__(self, name):
self.name=name
def info(self):
return f"计算器：{self.name}"
第二步：在其他文件中导入使用
# main.py - 使用自定义模块
import calculator
# 使用模块中的变量
print(calculator.PI) # 3.14159
print(calculator.VERSION) # 1.0
# 使用模块中的函数
result1=calculator.add(10, 20)
result2=calculator.subtract(50, 30)
result3=calculator.multiply(5, 6)
result4=calculator.divide(100, 4)
print(f"加法：{result1}") # 加法：30
print(f"减法：{result2}") # 减法：20
print(f"乘法：{result3}") # 乘法：30
print(f"除法：{result4}") # 除法：25.0
# 使用模块中的类
calc=calculator.Calculator("科学计算器")
print(calc.info()) # 计算器：科学计算器
输出：
3.14159
1.0
加法：30
减法：20
乘法：30
除法：25.0
计算器：科学计算器
2.2 模块的导入方式
方式一：import 模块名
导入整个模块，使用时需要加模块名前缀。
# 导入模块import calculator# 使用模块中的内容，需要加前缀print(calculator.PI)result = calculator.add(10, 20)print(result)
特点：
✅ 清晰明确，知道函数来自哪个模块
✅ 避免命名冲突
✅ 推荐使用
方式二：from 模块名 import 内容
只导入模块中的特定内容，使用时无需加前缀。
# 导入单个内容from calculator import addresult = add(10, 20)print(result) # 30# 导入多个内容from calculator import add, subtract, multiplyresult1 = add(10, 20)result2 = subtract(50, 30)result3 = multiply(5, 6)print(result1) # 30print(result2) # 20print(result3) # 30
特点：
✅ 代码简洁，无需加前缀
⚠️ 容易造成命名冲突
✅ 推荐在明确知道导入内容的情况下使用
方式三：from 模块名 import *
导入模块中的所有内容（通配符导入）。
# 导入模块中的所有内容from calculator import *# 直接使用，无需前缀print(PI)result1 = add(10, 20)result2 = subtract(50, 30)result3 = multiply(5, 6)print(result1) # 30print(result2) # 20print(result3) # 30
特点：
⚠️ 导入所有内容，容易造成命名冲突
⚠️ 代码可读性差，不知道函数来自哪里
❌ 不推荐使用
方式四：给模块起别名（as）
使用 as 关键字给模块或内容起别名，简化代码。
# 给模块起别名import calculator as calcresult = calc.add(10, 20)print(result) # 30# 给导入的内容起别名from calculator import add as additionresult = addition(10, 20)print(result) # 30# 给多个内容起别名from calculator import add as a, subtract as s, multiply as mresult1 = a(10, 20)result2 = s(50, 30)result3 = m(5, 6)print(result1) # 30print(result2) # 20print(result3) # 30
特点：
✅ 简化代码，特别是模块名很长时
✅ 避免命名冲突
✅ 推荐使用
2.3 导入方式对比总结
| 导入方式 | 语法 | 使用方式 | 优点 | 缺点 |
|---|
| import | import module | module.func() | 清晰明确 | 代码较长 |
| from-import | from module import func | func() | 代码简洁 | 容易冲突 |
| import * | from module import * | func() | 最简洁 | 不推荐 |
| as 别名 | import module as m | m.func() | 灵活简洁 | 需要记住别名 |
推荐使用顺序：
首选：import module 或 import module as m
次选：from module import func（明确知道导入内容）
避免：from module import *
2.4 导入内置模块示例
示例一：os 模块（操作系统接口）
import os# 获取当前工作目录print(os.getcwd())# 列出目录中的文件print(os.listdir('.'))# 创建目录# os.mkdir('new_folder')# 删除目录# os.rmdir('new_folder')# 获取文件大小# print(os.path.getsize('file.txt'))
输出示例：
C:\Users\YourName\project['main.py', 'calculator.py', 'data.txt']
示例二：random 模块（随机数）
import random# 生成随机整数print(random.randint(1, 10)) # 1-10 之间的随机整数# 生成随机浮点数print(random.random()) # 0-1 之间的随机浮点数# 从列表中随机选择colors = ['红', '绿', '蓝', '黄']print(random.choice(colors)) # 随机选择一个颜色# 随机打乱列表numbers = [1, 2, 3, 4, 5]random.shuffle(numbers)print(numbers) # 打乱后的列表
输出示例：
70.3456789蓝[3, 1, 5, 2, 4]
示例三：time 模块（时间相关）
import time# 获取当前时间戳print(time.time()) # 1703275200.123# 暂停程序执行print("开始")time.sleep(2) # 暂停 2 秒print("结束")# 获取当前时间的结构化信息print(time.localtime()) # time.struct_time(...)
输出示例：
1703275200.123开始（暂停 2 秒）结束time.struct_time(tm_year=2023, tm_mon=12, tm_mday=23, ...)
示例四：math 模块（数学函数）
import math# 圆周率print(math.pi) # 3.141592653589793# 平方根print(math.sqrt(16)) # 4.0# 向上取整print(math.ceil(3.2)) # 4# 向下取整print(math.floor(3.8)) # 3# 绝对值print(math.fabs(-5)) # 5.0# 幂运算print(math.pow(2, 3)) # 8.0
输出：
3.1415926535897934.0435.08.0
2.5 模块的搜索路径
当 Python 导入模块时，会按照特定顺序搜索：
当前目录（最优先）
PYTHONPATH 环境变量指定的目录
Python 安装目录
# 查看模块搜索路径import sysprint(sys.path)
输出示例：
['', 'C:\\Users\\YourName\\AppData\\Local\\Programs\\Python\\Python39\\lib\\site-packages', ...]
说明：
空字符串 '' 表示当前目录
其他路径是 Python 的标准库和第三方库路径
2.6 模块的重要属性
每个模块都有一些内置属性，可以用来获取模块的信息：
import calculator# __name__：模块名print(calculator.__name__) # calculator# __file__：模块文件路径print(calculator.__file__) # C:\...\calculator.py# __doc__：模块的文档字符串print(calculator.__doc__) # None（如果没有定义）# __dict__：模块的命名空间（所有定义的内容）print(calculator.__dict__) # {...}# dir()：列出模块中的所有内容print(dir(calculator)) # ['PI', 'VERSION', 'add', 'subtract', ...]
输出示例：
calculatorC:\Users\YourName\project\calculator.pyNone{...}['PI', 'VERSION', 'add', 'subtract', 'multiply', 'divide', 'Calculator']
2.7 if name == 'main' 的作用
这是 Python 中的一个常见模式，用来区分模块是被导入还是被直接运行。
# calculator.pydef add(a, b): return a + b# 这段代码只在直接运行此文件时执行，导入时不执行if __name__ == '__main__': print("这是直接运行 calculator.py") result = add(10, 20) print(result)
# main.pyimport calculator# 导入 calculator 时，if __name__ == '__main__' 下的代码不会执行result = calculator.add(5, 15)print(result)
运行结果：
# 直接运行 calculator.py这是直接运行 calculator.py30# 运行 main.py20
作用：
✅ 模块既可以被导入使用，也可以被直接运行
✅ 便于测试和调试
✅ 避免导入时执行不必要的代码
3. 常见问题解决
3.1 模块找不到（ImportError）
问题：
ModuleNotFoundError: No module named 'xxx'
原因和解决方案：
| 原因 | 解决方案 |
|---|
| 模块文件不存在 | 检查文件名是否正确，是否在正确的目录 |
| 模块不在搜索路径中 | 将模块所在目录添加到 sys.path |
| 拼写错误 | 检查导入语句中的模块名是否正确 |
| 第三方模块未安装 | 使用 pip install 安装模块 |
解决示例：
# 方案1：确保模块在当前目录# 项目结构：# project/# ├── main.py# └── calculator.pyimport calculator # ✓ 正确# 方案2：添加路径到 sys.pathimport syssys.path.append('C:/path/to/module')import my_module # ✓ 正确# 方案3：检查拼写import calculator # ✓ 正确# import calculater # ✗ 错误
3.2 循环导入
问题： 两个模块互相导入，导致错误
# module_a.pyfrom module_b import func_b# module_b.pyfrom module_a import func_a # 循环导入！
解决方案：
# 方案1：重新设计模块结构，避免相互依赖# 创建第三个模块 module_c.py，包含共享的函数# 方案2：在函数内部导入，而不是模块顶部导入# module_a.pydef func_a(): from module_b import func_b # 在函数内导入 func_b()
3.3 导入路径问题
问题： 导入自定义模块时找不到
解决方案：
# 方案1：确保模块在当前目录或子目录# 项目结构：# project/# ├── main.py# └── utils/# └── helper.py# 在 main.py 中from utils import helper # ✓ 正确# 方案2：添加路径到 sys.pathimport syssys.path.append('C:/path/to/module')import my_module# 方案3：使用相对导入（仅在包内使用）from . import helper
本篇总结
| 知识点 | 核心内容 |
|---|
| 模块的定义 | 一个 .py 文件就是一个模块 |
| 模块的分类 | 内置模块、自定义模块、第三方模块 |
| 模块的优点 | 提高可维护性、复用性、避免命名冲突 |
| 导入方式 | import、from-import、import *、as 别名 |
| 推荐做法 | 优先使用 import module 或 import module as m |
| 常用内置模块 | os、random、time、math、datetime、json |
| 模块属性 | __name__、__file__、__doc__、__dict__ |
| 常见问题 | 模块找不到、循环导入、路径问题 |
实战小练习
练习一：创建一个工具模块
# tools.pydef get_max(a, b, c): """获取三个数中的最大值""" return max(a, b, c)def get_min(a, b, c): """获取三个数中的最小值""" return min(a, b, c)def get_avg(a, b, c): """获取三个数的平均值""" return (a + b + c) / 3if __name__ == '__main__': print(get_max(10, 20, 30)) print(get_min(10, 20, 30)) print(get_avg(10, 20, 30))
# main.pyfrom tools import get_max, get_min, get_avgresult1 = get_max(5, 15, 10)result2 = get_min(5, 15, 10)result3 = get_avg(5, 15, 10)print(f"最大值：{result1}")print(f"最小值：{result2}")print(f"平均值：{result3}")
输出：
📌 关注我，下篇继续讲解包和第三方模块：包的概念、第三方模块安装与使用、pip 命令详解！
