上一章我们已经把“模块”这个概念讲清楚了。你已经知道:
一个 .py 文件,通常就可以看作一个模块。 代码之所以要拆成多个文件,是因为项目一旦变大,所有内容堆在一个文件里会越来越乱。 模块的价值,不只是为了能运行,更是为了让代码结构更清晰、更容易复用。
那接下来,一个非常现实的问题就来了:
文件拆开以后,这些文件之间到底怎么互相使用?
比如你把数学函数写进了 my_math.py。 那主程序怎么调用里面的 add() 和 sub()? 比如你把 Book 类写进了 book.py。 那 main.py 里又该怎么创建图书对象?
这时候,就轮到 import 登场了。
这一章,我们就把 Python 里最常见的几种导入写法,一次讲清楚。你会发现,import 本身并不难,难的是很多人一开始没搞清楚“到底导进来了什么”。
一、先说结论:import 的本质是什么
你先记一句最核心的话:
import 的本质,就是把别的模块里的内容拿过来用。
注意,这里的“拿过来”不是复制粘贴一份代码,而是让当前文件获得对另一个模块内容的访问能力。
比如你有一个文件:
my_math.py
里面写着:
defadd(a, b):return a + b
那你在另一个文件里通过 import,就可以去用这个 add()。
所以 import 最本质的作用,不是神秘地加载什么,而是:
让不同文件之间建立联系。
这一步一旦理解了,后面的各种写法就只是不同使用姿势。
二、最基础的写法:import 模块名
先看最常见、最基础的一种:
import 模块名
比如:
import my_math
如果 my_math.py 里有下面这些内容:
defadd(a, b):return a + bdefsub(a, b):return a - b
那在主程序里,你就可以这样用:
import my_mathprint(my_math.add(3, 5))print(my_math.sub(10, 4))
输出结果:
86
这就是最经典的模块导入方式。
注意这个写法里最关键的一点:
导入模块后,要用 模块名.内容名 的方式访问。
也就是说,add() 不是直接跑到你当前命名空间里来了。 它还是挂在 my_math 这个模块名下面。
所以你得写:
my_math.add(3, 5)
而不是直接写:
add(3, 5)
这个区别非常重要。
三、为什么这种写法很推荐
因为它清楚。
你一看到:
my_math.add(3, 5)
就立刻知道,add() 是从 my_math 模块来的。 来源非常明确。
这在代码稍微变大一点时,价值就特别高。
因为一个项目里可能有很多函数、很多类。 如果全都直接导进当前作用域,时间一长你就容易忘记某个名字到底来自哪里。
而 模块名.内容名 这种写法,天然就带着出处。 读起来更稳,也更不容易冲突。
所以从代码清晰度来说,import 模块名 通常是一种非常好的默认选择。
四、第二种常见写法:from 模块名 import 内容名
除了整模块导入,还有一种非常常见的写法:
from 模块名 import 内容名
比如:
from my_math import add
这时候你就可以直接写:
print(add(3, 5))
而不必再写:
my_math.add(3, 5)
这说明什么?
说明这种写法导入的不是整个模块名,而是模块里的某个具体内容。
你可以把它理解成:
我不要整个工具箱 我只拿工具箱里的这把螺丝刀
这就是它和 import 模块名 的最大区别。
五、这种写法的优点和缺点是什么
优点很直接:写起来更短。
比如:
from my_math import add, subprint(add(3, 5))print(sub(10, 4))
这样当然比:
import my_mathprint(my_math.add(3, 5))print(my_math.sub(10, 4))
更短一点。
但它也有一个明显代价:
来源感会变弱。
你看到 add(),如果上下文不明显,就不一定一眼知道它来自哪个模块。 尤其当项目里很多模块都可能有同名函数时,这种写法更容易让代码来源变模糊。
所以这类写法适合什么场景?
模块内容很少 导入对象非常明确 你很确定不会产生命名冲突 当前文件里确实会频繁使用它
这些情况下,用 from ... import ... 会比较顺手。
六、第三种写法:from 模块名 import 多个内容
这个其实是上一种的延伸。
比如:
from my_math import add, sub
或者:
from book import Book, PaperBook, EBook
这时候你导入的是多个具体名字。
例如:
from book import Book, PaperBookb1 = Book('Python 入门', '小王')b2 = PaperBook('数据分析实战', '老李', 320)
这类写法在导入多个类时特别常见。因为如果你本来就只想用 book.py 里的那几个类,直接把类名拿进来,写起来会比较自然。
不过同样要记住一个原则:
导得越具体,写起来越短,但来源也越不明显。
所以这不是绝对更高级,只是不同取舍。
七、第四种写法:import 模块名 as 别名
当模块名比较长,或者你想写得更简洁时,经常会用这种方式:
import 模块名 as 别名
例如:
import my_math as mm
然后使用时:
print(mm.add(3, 5))print(mm.sub(10, 4))
这其实很好理解。
模块还是整个导进来了。 只是你以后不再叫它 my_math,而是叫它 mm。
为什么会有这个写法?
因为有些模块名比较长。 比如以后你会经常看到:
import numpy as npimport pandas as pd
就是这个思路。
这类写法的价值主要有两个。
第一,少打字。 第二,保留“模块来源感”的同时,让代码更简洁。
所以它可以看作是 import 模块名 的简化版。
八、第五种写法:from 模块名 import 内容名 as 别名
如果你既想导入某个具体内容,又想给它换个短一点或更顺手的名字,就可以这样写:
from 模块名 import 内容名 as 别名
例如:
from my_math import add as my_add
使用时:
print(my_add(3, 5))
这种写法没前几种常见,但在一些名字冲突或者想让名字更清晰的场景里会很有用。
比如你从两个不同模块里都导入了 open_file(),那就可能需要给其中一个起别名,避免混淆。
你现在不用刻意多用它,但至少要看得懂。
**九、最不推荐新手滥用的一种写法:from 模块名 import ***
还有一种写法,你一定会见到:
from my_math import *
表面意思很简单:
把 my_math 模块里的所有公开内容,全都导进当前文件。
这样你就可以直接写:
print(add(3, 5))print(sub(10, 4))
看起来是不是很省事?
是的,短期看确实省事。 但它的问题也非常明显:
你根本不清楚当前文件里到底突然多了哪些名字。
这会带来几个麻烦:
来源不清晰 容易和当前文件自己的变量、函数重名 代码一大就很难维护 别人读代码时会非常痛苦
所以对新手来说,这种写法最容易养成坏习惯。 你会觉得方便,但后面代码一复杂,很容易把自己也绕进去。
所以现在你可以直接记住:
from 模块 import * 尽量少用,入门阶段基本可以认为不推荐。
十、现在把几种写法放在一起对比一下
假设模块 my_math.py 里有一个 add() 函数。
第一种:
import my_mathprint(my_math.add(3, 5))
特点:最清楚,来源明确。
第二种:
from my_math import addprint(add(3, 5))
特点:更短,但来源感弱一点。
第三种:
import my_math as mmprint(mm.add(3, 5))
特点:兼顾来源感和简洁。
第四种:
from my_math import add as my_addprint(my_add(3, 5))
特点:适合改名或避免冲突。
第五种:
from my_math import *print(add(3, 5))
特点:看起来省事,但不够清晰,不推荐滥用。
只要这组对比你理顺了,import 的主体框架就已经非常清楚了。
十一、到底什么时候该用哪一种
这是这一章最实用的部分。
如果你想要代码最清楚、最稳妥,默认优先考虑:
import 模块名
或者:
import 模块名 as 别名
因为来源清晰。
如果你只需要模块里的某一个类、某几个函数,而且这些名字非常明确,也不太会冲突,那可以考虑:
from 模块名 import 内容名
或者:
from 模块名 import 内容1, 内容2
如果你遇到名字冲突,或者想让导入后的名字更贴近当前语境,就用:
as
如果是:
from 模块 import *
则尽量少碰。
你可以先记一个很够用的经验规则:
默认用 import 模块名,需要更短更直接时再考虑 from ... import ...。
这条规则对入门阶段非常稳。
十二、为什么很多正式代码更偏爱“模块名.内容名”
因为一旦项目变大,来源感真的非常重要。
比如你看到:
config.load_config()logger.info('程序启动')book.create_book()user.login()
每个名字一看就知道大概来自哪里。
而如果全写成:
load_config()info('程序启动')create_book()login()
虽然也能跑,但来源不清晰。 一旦某个函数报错、重名、需要修改,排查成本会明显变高。
所以你会发现,很多正式项目在导入时并不是一味追求短,而是更重视:
可读性 清晰度 来源明确
这也是为什么“怎么 import”其实不仅是语法问题,还是代码风格问题。
十三、导入类和导入函数,本质上没有区别
这个点也很重要。
比如你写:
from book import Book
这里导入的是类。
而你写:
from my_math import add
这里导入的是函数。
对 import 来说,本质逻辑是一样的。 都是把某个模块里的一个名字,拿到当前文件来用。
所以你不用把“导入类”和“导入函数”当成两套知识。 它们只是导入的对象不同而已。
这也说明模块里可以装很多种代码内容,而 import 本身只是建立访问关系。
十四、前面图书项目,如果拆模块,主程序会怎么导入
上一章我们做了图书借阅系统。 假设现在你已经按模块拆成这样:
book.py放 Book、PaperBook、EBook
user.py放 User
library.py放 Library
那主程序 main.py 很可能会这样写:
from book import Book, PaperBook, EBookfrom user import Userfrom library import Library
然后你在主程序里就能直接写:
book1 = PaperBook('Python 入门', '小王', 320)user1 = User('张三')library = Library('阳光图书馆')
这时候你就会明显感觉到:
模块拆分让结构更清楚 而 import 则负责把这些拆开的部分重新连起来
这两者其实是配套出现的。
十五、为什么 import 语句通常写在文件开头
你会发现,大多数 Python 文件里,import 都写在最前面。
这是一个非常常见的习惯,也非常合理。
因为读代码的人,一打开文件,通常就想先知道:
这个文件依赖了哪些模块 用了哪些外部功能 有哪些类和函数是从别处拿来的
所以把 import 放在开头,会让依赖关系一目了然。
当然,特殊情况下你也可能在函数里导入,但那通常是更后面的使用技巧。 你现在先养成一个好习惯就行:
常规导入,优先放文件顶部。
十六、import 不只是语法,更是在建立“依赖关系”
这个视角很重要。
一旦你在当前文件里写了:
import my_math
或者:
from book import Book
其实就说明了一件事:
当前文件依赖另一个模块提供的能力。
所以导入语句不是孤零零的,它在项目结构里表达的是“谁依赖谁”。
这件事以后会越来越重要。 因为当项目继续变大时,模块之间依赖关系混乱,代码就会越来越难维护。
所以从现在开始,你可以慢慢建立这个意识:
每写一个 import,都是在声明当前文件要借用别的地方的能力。
这会帮助你以后更好地看懂项目结构。
十七、一个很常见的误区:以为 import 是把代码复制进来了
不是这样理解。
你可以把它理解成“建立访问通道”,而不是“复制粘贴整份代码”。
这点现在不需要深挖底层机制,只要先知道:
导入不是简单拷贝文本 它是在让当前文件能访问另一个模块里定义好的名字
这样理解会更准确,也更利于后面学包和模块缓存时继续往前走。
十八、再给你一个很实用的选择建议
如果你现在还不太确定某种写法什么时候合适,那就先用下面这套很稳的默认习惯:
导入整个模块时,用:
import 模块名
模块名太长时,用:
import 模块名 as 别名
只导入少量非常明确的类或函数时,用:
from 模块名 import 内容名
尽量别一上来就写:
from 模块名 import *
这套习惯已经足够让你写出很清楚的入门级项目代码。
十九、本章小练习
你可以做两个很适合巩固的练习。
第一个练习:
新建一个 my_math.py 文件,写入:
add()sub()mul()
然后在 main.py 里分别用下面两种方式试一遍:
import my_math
和:
from my_math import add, sub
对比一下调用方式的区别。
第二个练习:
把你之前写过的 Book 类单独放到 book.py。 然后在主程序里分别试一试:
import book
以及:
from book import Book
看看创建对象时写法有什么区别。
这个练习非常有帮助,因为 import 的区别,很多时候不是靠看,而是靠自己真正写一遍最容易记住。
二十、本章总结
这一章,我们把 import 最常见的几种写法理清楚了。
import 模块名 是最基础、最清楚的一种写法,使用时要写成 模块名.内容名。from 模块名 import 内容名 可以直接导入具体内容,写起来更短。as 可以给模块名或导入内容起别名。from 模块 import * 看起来方便,但来源不清晰,入门阶段尽量少用。 选择哪种写法,不只是语法问题,更是代码清晰度和可维护性的问题。 模块负责把代码拆开,import 负责把拆开的代码重新连起来。
下一章我们继续往前走,进入更进一步的内容:083|自定义模块与包:你的代码也可以被别人导入。