先说点儿背景，别把模块当成啥高深玩意儿

Python里一个 .py 文件就是一个模块，哈哈。

别想太多，文件名就是模块名，去掉后缀。

要是你把它放进了项目的根目录，直接 import 就行。

咱就是说这跟把玩具放进抽屉里一拿就Neng找得到。

为什么要用包？

项目大了文件多了光靠一个目录会乱成一锅粥。

这时候就需要包——其实就是装模块的文件夹。

包里必须有个 __init__.py，哪怕空着也行。

这个文件告诉 Python “这里是个包”。

导入方式大盘点

Zui常见的两种：import 模块 和 from 模块 import 名字。

import os 把整个模块拉进来你得写 os.path 才Neng用。

from os import path 把名字直接塞到当前命名空间，省事儿。

as 别名 geng好玩，比如 import numpy as np，以后敲 np 就行。

相对导入 VS 绝对导入

绝对导入：

from myproject.utils.helper import func

相对导入：

from .helper import func

注意点：相对导入只Neng在包内部使用，直接跑脚本会报错——不对不对，是因为你没把它当作包运行。

__all__ 的小秘密

# __all__ =

星号导入只会把 __all__ 里列的东西拉进来。

新手Zui好别滥用星号，否则代码可读性直线下降。

循环导入坑，你踩过吗？

A 模块 import B，B 又 import A——这叫循环依赖。

Pythons 会在第一次 import 时创建一个半成品的模块对象，然后继续执行后面的代码。

结果往往是属性未定义报错。解决办法：把公共部分抽出来单独建个模块，或者延迟导入。

"为什么百度不收录" 的奇怪插曲

写了这么多技术文章，为啥百度搜索老是不收录呢？

可Neng是因为页面缺少 meta description 或者标题没有关键词密度够高。还有，就是服务器返回的 HTTP 状态码不是 200，也会被排除。说实话，把标题和正文里的关键词自然嵌进去，多加几段含关键词的描述，就Neng提升收录率啦。哈哈，这招我自己也在实验中验证过。

实战案例：从零搭建一个小博客系统的包结构

a) 创建根目录 myblog/ 。

b) 在 myblog/ 下新建子目录 core/、models/、utils/ ，每个子目录里放一个空的 __init__.py 。

C) core/__init__.py Ke以写上 # 包入口，可选地暴露公共 API

D) core/app.py 里写主入口函数：

def main:
    print
if __name__ == "__main__":
    main

D) 如何在别处调用 main

# 在项目根目录下的新脚本 run.py 中：

from myblog.core.app import main
main

常见错误清单

- 文件名和标准库冲突：

# 不要自己建个 json.py，会覆盖内置 json
import json   # 结果加载的是自己的文件，报错

- 忘记加入 init.py：

# 包结构kan起来像：
mypkg/
    subpkg/
        module.py

from mypkg.subpkg import module   # ImportError

- 用相对路径写死：

# 错误写法：
import sys.path.append

import sys
sys.path.append))

小技巧合集，让你玩转 import geng顺手

# 动态导入：

module = import
func = getattr
func

# 使用 pathlib 操作路径geng安全

from pathlib import Path
BASE = Path.parent
sys.path.append)

# 给模块起别名避免冲突

import pandas as pd   # 常规别名
import myproject.pandas as pd_custom   # 同时保留两个版本

# 查kanYi加载模块

import sys
print))

# 用 all 控制星号导入范围

# utils/init.py
all = 
from .helper import *
from .constants import *

# 打印当前搜索路径排查找不到的问题

import sys; print)

# 用 if name == 'main' 防止脚本被误执行

def test:
    print
if name == 'main':
    test

# 避免硬编码路径，用包资源读取数据

import pkgutil, io

data = pkgutil.getdata
config = yaml.safeload)

# 想让你的自定义模块像标准库一样易于发现？ 把它放到项目根目录或通过 pip install -e . 安装为可编辑模式，这样 sys.path 会自动包含它。

别给自己太大压力

SAY GOOD BYE TO 那些“ImportError: No module named …” 的尴尬瞬间吧！

"懂了嘛？"

---