1. 作用

• 模块缓存：
  每当通过 import 语句导入一个模块时，Python 会先检查 sys.modules 是否已存在该模块的缓存：

  • 已缓存：直接使用缓存中的模块对象，不再执行模块代码。
  • 未缓存：加载模块代码，并将模块对象存入 sys.modules。

• 模块唯一性：
  每个模块在 sys.modules 中以模块名为键存储（例如 "numpy" 或 "my_package.my_module"），确保同一模块名对应的模块对象全局唯一。

---

2. 查看 sys.modules

import sys

# 打印所有已加载的模块名
print(sys.modules.keys())

# 查看某个模块是否已加载
if "numpy" in sys.modules:
    print("numpy 已加载")

---

3. 关键特性

(1) 模块名的唯一性

• 模块名由导入路径决定，例如：
  • 绝对路径导入：import my_package.my_module → 模块名为 "my_package.my_module"。
  • 相对路径导入：from .. import my_module → 模块名取决于当前包的层级（如 "parent_package.my_module"）。
• 不同路径导入同一文件会生成不同的模块名，导致 sys.modules 中存在多个条目，模块被重复加载。

(2) 模块缓存的生命周期

• 模块一旦加载，会一直存在于 sys.modules 中，直到程序结束。
• 可通过 del sys.modules["module_name"] 手动移除缓存（不推荐，可能导致状态混乱）。

---

4. 示例分析

场景：模块重复加载

# 文件结构
# project/
# ├── main.py
# └── my_module.py

# my_module.py
print("模块 my_module 已加载")

# main.py
import sys
import my_module  # 输出 "模块 my_module 已加载"

print(sys.modules["my_module"])  # 显示模块对象

# 手动移除缓存
del sys.modules["my_module"]

# 再次导入
import my_module  # 再次输出 "模块 my_module 已加载"

---

5. 实际应用

(1) 避免模块重复加载

• 统一导入路径：确保所有模块通过绝对路径导入，避免因路径不同导致模块名差异。

  # 正确：统一使用绝对路径
  from my_package import my_module
  
  # 错误：混合绝对路径和相对路径
  from ..my_package import my_module

(2) 强制重新加载模块

在调试时，可用 importlib.reload() 重新加载模块（慎用）：

import importlib
import my_module

# 修改 my_module.py 后重新加载
importlib.reload(my_module)

(3) 动态导入控制

通过操作 sys.modules 实现动态加载：

# 手动加载模块（不推荐常规使用）
module_name = "my_module"
if module_name not in sys.modules:
    import importlib

    module = importlib.import_module(module_name)
    sys.modules[module_name] = module

---

6. 注意事项

• 不要手动修改 sys.modules：除非明确需要动态控制模块加载，否则可能引发不可预知的行为。
• 模块名是唯一标识：确保模块导入路径的一致性，避免因路径差异导致缓存失效。

---

总结

• sys.modules 是模块加载的全局缓存，决定模块是否重复加载。
• 模块名是缓存的关键，路径不一致会导致重复加载。
• 最佳实践：统一导入路径，依赖 Python 默认的缓存机制，避免手动干预。