Python import语句详解（新手也能轻松掌握的模块导入指南）

什么是模块和包？

在深入 import 之前，先搞清楚两个基本概念：

• 模块（Module）：一个 .py 文件就是一个模块，比如 math.py、os.py。
• 包（Package）：包含多个模块的文件夹，且必须包含一个名为 __init__.py 的文件（即使为空）。

基本 import 语法

最简单的导入方式是直接使用 import 关键字：

import math# 使用时需要加上模块名print(math.sqrt(16))  # 输出: 4.0

from ... import ... 语法

如果你只想导入模块中的某个函数或变量，可以使用 from ... import ...：

from math import sqrt# 直接使用函数名print(sqrt(16))  # 输出: 4.0

你也可以一次导入多个内容：

from math import sqrt, pi, sinprint(pi)        # 输出: 3.141592653589793print(sin(pi/2)) # 输出: 1.0

使用 as 起别名

为了代码简洁或避免命名冲突，可以使用 as 给模块或函数起别名：

import numpy as npfrom matplotlib import pyplot as plt# 现在可以用 np 和 plt 来调用arr = np.array([1, 2, 3])plt.plot(arr)plt.show()

导入整个模块的内容（慎用）

使用 from module import * 可以导入模块中所有公开内容（不以下划线开头的）：

from math import *print(sqrt(25))  # 输出: 5.0print(cos(0))    # 输出: 1.0

注意：这种方式虽然方便，但容易造成命名空间污染和函数覆盖，建议只在交互式环境（如 Jupyter Notebook）中使用，正式项目中应避免。

导入自定义模块和包

假设你的项目结构如下：

myproject/├── main.py└── utils/    ├── __init__.py    └── helper.py

在 helper.py 中定义一个函数：

# utils/helper.pydef greet(name):    return f"Hello, {name}!"

在 main.py 中导入并使用：

# main.pyfrom utils.helper import greetprint(greet("Alice"))  # 输出: Hello, Alice!

常见错误与最佳实践

• 循环导入：模块 A 导入模块 B，而模块 B 又导入模块 A，会导致错误。应重构代码避免。
• 导入顺序：PEP8 建议按标准库、第三方库、本地模块的顺序分组导入，每组之间空一行。
• 避免星号导入：如前所述，from module import * 应谨慎使用。

总结

掌握 Python import语句 是迈向高效 Python编程入门 的关键一步。通过合理使用 import、from ... import ... 和 as，你可以灵活地组织代码、复用功能，并有效管理 Python包管理。希望这篇教程能帮你彻底理解 Python模块导入 的各种方式！

Happy Coding with Python! 🐍