import 语句必须写在模块顶层,不可缩进或嵌套;应统一置于文件最上方(__future__之后),延迟加载用importlib.import_module();优先用import xxx而非from xxx import yyy以避免命名污染。

import 语句到底该写在哪儿
Python 的 import 必须出现在模块顶层,不能缩进、不能嵌套在函数或条件块里——否则运行时会报 ImportError 或触发意外的导入时机问题。常见错误是把 import requests 放在某个 if 分支里,本意是“按需加载”,结果导致其他路径下变量未定义。
实操建议:
- 所有
import统一放在文件最上方(__future__之后、其他代码之前) - 需要延迟加载时,用字符串导入:
mod = __import__('json')或更安全的importlib.import_module('pkg.submod') - 避免在循环或高频调用函数里反复
import—— Python 会缓存已导入模块,但 import 语句本身仍有解析开销
from xxx import yyy 和 import xxx 的区别不只是写法
写 from requests import get 看似省事,但会污染当前命名空间,且掩盖模块来源;而 import requests 虽多打几个字,却让调用意图清晰、便于 mock 和替换。
实操建议:
- 公共库(如
requests、numpy)优先用import xxx,调用时写requests.get() - 只在明确需要简化长名时才用
from xxx import yyy,且仅限单个符号(不推荐from xxx import *) - 如果导入的是同名函数(比如两个包都叫
load),必须用别名:from yaml import load as yaml_load,否则后导入的会覆盖前一个
静态导入不存在于 Python,别被 Java 术语带偏
Python 没有“静态导入”这个概念。Java 的 static import 是为了省略类名调用静态方法,而 Python 的模块本身就是命名空间容器,所有导入都是“静态”的(即编译期确定路径,运行期绑定对象)。
实操建议:
- 不要搜索 “python static import”,那是无效关键词
- 想实现类似效果(比如直接用
get()而非requests.get()),本质是命名空间控制问题,靠from ... import实现,但要承担命名冲突风险 - 工具链(如 mypy、pylint)对
from x import *会报警,因为无法静态推导符号来源
第三方库没找到?先确认是不是 import 路径错了
报错 ModuleNotFoundError: No module named 'xxx' 不代表没装,很可能是当前 Python 解释器没看到安装位置。尤其在虚拟环境、IDE 内置解释器、conda 环境混用时极易发生。
实操建议:
- 运行
python -c "import sys; print('\n'.join(sys.path))"查看实际搜索路径 - 检查是否用了错误的 pip:比如系统 Python 装了
requests,但 VS Code 默认跑的是 venv 里的 Python,它里面没装 - 临时加路径不是长久之计:
sys.path.insert(0, '/path/to/lib')容易引发版本混乱,应优先用pip install -e .或正确激活环境
import 的本质是查找并执行模块文件,不是声明。路径、环境、解释器三者对不上,再标准的写法也白搭。










