Python学习--模块导入详解

# 基本导入import mathimport sysimport os# 使用模块中的内容（需要模块名.属性名）print(math.pi)           # 3.141592653589793print(math.sqrt(16))     # 4.0# 获取当前工作目录print(os.getcwd())# 获取命令行参数print(sys.argv)

# 为模块起别名（常用于名称较长或有冲突的模块）import numpy as npimport pandas as pdimport matplotlib.pyplot as plt# 使用别名访问arr = np.array([1, 2, 3])print(arr)# 自定义别名import math as mprint(m.pi)print(m.sqrt(25))

# 一行导入多个模块import math, sys, os, json# 或使用括号提高可读性import (    math,    sys,    os,    json)print(math.pi)print(sys.version)print(os.name)print(json.dumps({"name": "Alice"}))

# 优点：避免命名冲突def sqrt(x):    return x ** 2import mathprint(math.sqrt(16))  # 4.0（使用模块的sqrt）print(sqrt(16))        # 256（使用自定义函数）# 缺点：每次使用都需要写模块名import statisticsdata = [1, 2, 3, 4, 5]mean = statistics.mean(data)      # 需要写模块名median = statistics.median(data)  # 需要写模块名stdev = statistics.stdev(data)    # 需要写模块名

# 导入特定函数或变量from math import pi, sqrt, sin, cosfrom datetime import datetimefrom random import randint# 直接使用，不需要模块名前缀print(pi)           # 3.141592653589793print(sqrt(100))    # 10.0print(sin(pi/2))    # 1.0print(cos(0))       # 1.0# 使用 datetimenow = datetime.now()print(now)# 使用 randomprint(randint(1, 10))

# 为导入的对象起别名（解决命名冲突或简化名称）from math import sqrt as square_rootfrom datetime import datetime as dtfrom statistics import mean as averageprint(square_root(144))  # 12.0print(dt.now())          # 当前时间print(average([1, 2, 3, 4, 5]))  # 3.0# 解决命名冲突def open(filename):    return f"自定义打开: {filename}"# 使用别名避免冲突from os import open as os_openprint(open("test.txt"))      # 使用自定义函数print(os_open("test.txt"))   # 使用os模块的open函数

# 从模块导入类from collections import defaultdict, Counter, dequefrom dataclasses import dataclass# 使用 defaultdictd = defaultdict(int)d['a'] += 1print(d)# 使用 Counterc = Counter([1, 2, 2, 3, 3, 3])print(c)# 使用 dequeq = deque([1, 2, 3])q.appendleft(0)print(q)# 使用 dataclass@dataclassclass Person:    name: str    age: intp = Person("Alice", 25)print(p)

# 优点：代码简洁，直接使用函数名from math import sqrt, powprint(sqrt(100))  # 简洁print(pow(2, 3))  # 简洁# 缺点：可能导致命名冲突def pow(x, y):  # 覆盖了导入的pow函数    return x ** y * 2from math import pow  # 如果先导入，后面的自定义会覆盖

# 导入模块中的所有公共对象from math import *from random import *from datetime import *# 直接使用所有函数和变量print(pi)           # 3.141592653589793print(sin(pi/2))    # 1.0print(sqrt(100))    # 10.0# random模块的函数print(randint(1, 10))print(random())print(choice(['a', 'b', 'c']))# datetime模块now = datetime.now()print(now)print(date.today())

# 模块可以通过 __all__ 控制 from module import * 导入的内容# mymodule.py__all__ = ['public_function', 'PublicClass']def public_function():    passdef _private_function():  # 以下划线开头不会被导入    passclass PublicClass:    passclass _PrivateClass:  # 以下划线开头不会被导入    pass# 使用 from module import *from mymodule import *# 只能导入 __all__ 中指定的内容public_function()    # 可用PublicClass()        # 可用# _private_function()  # 不可用# _PrivateClass()      # 不可用

# 优点：交互式环境快速测试# 在IPython或Jupyter中：from numpy import *from matplotlib.pyplot import *# 可以快速使用所有函数arr = array([1, 2, 3])plot(arr)# 缺点：污染命名空间，容易产生冲突from math import *from cmath import *  # 冲突！都定义了sqrtprint(sqrt(-1))  # 哪个sqrt？结果不确定# 解决方法：明确导入或使用别名import mathimport cmathprint(math.sqrt(4))   # 2.0print(cmath.sqrt(-1)) # 1j

# 示例模块：calculator.py"""简单的计算器模块"""def add(a, b):    return a + bdef subtract(a, b):    return a - bdef multiply(a, b):    return a * bdef divide(a, b):    if b == 0:        raise ValueError("除数不能为0")    return a / bPI = 3.14159E = 2.71828# 方式1：直接导入模块import calculatorprint(calculator.add(10, 5))      # 15print(calculator.PI)               # 3.14159print(calculator.divide(10, 2))    # 5.0# 方式2：导入特定对象from calculator import add, multiply, PIprint(add(10, 5))      # 15（不需要模块名前缀）print(multiply(10, 5)) # 50print(PI)              # 3.14159# print(subtract(10, 5))  # 错误！subtract没有被导入# 方式3：导入所有对象（不推荐）from calculator import *print(add(10, 5))      # 15print(subtract(10, 5)) # 5print(multiply(10, 5)) # 50print(divide(10, 2))   # 5.0print(PI)              # 3.14159print(E)               # 2.71828

def import_guide():    """导入方式选择指南"""    # 场景1：需要使用模块的多个功能    # 推荐：import module    import math    radius = 5    area = math.pi * math.pow(radius, 2)    circumference = 2 * math.pi * radius    # 场景2：只需要少数几个函数    # 推荐：from module import func    from datetime import datetime, date    now = datetime.now()    today = date.today()    # 场景3：避免命名冲突    # 推荐：import module 或 from module import func as alias    import statistics as stats    mean = stats.mean([1, 2, 3])    from math import sqrt as square_root    result = square_root(100)    # 场景4：交互式环境快速测试    # 推荐：from module import *（仅限交互式环境）    # 在Jupyter或IPython中：    # from numpy import *    # from matplotlib.pyplot import *    # 场景5：自定义模块，需要控制导出内容    # 在模块中定义 __all__ 列表    pass

# 问题代码# module_a.pyfrom module_b import func_bdef func_a():    return func_b()# module_b.pyfrom module_a import func_adef func_b():    return func_a()# 解决方案1：延迟导入# module_a.pydef func_a():    from module_b import func_b    return func_b()# module_b.pydef func_b():    from module_a import func_a    return func_a()# 解决方案2：导入模块而不是函数# module_a.pyimport module_bdef func_a():    return module_b.func_b()# module_b.pyimport module_adef func_b():    return module_a.func_a()# 解决方案3：重构代码，将公共部分提取到第三个模块# common.pydef common_function():    pass# module_a.pyfrom common import common_function# module_b.pyfrom common import common_function

# 最佳实践：使用依赖注入# 不好的设计（容易循环导入）# service_a.pyfrom service_b import ServiceBclass ServiceA:    def __init__(self):        self.service_b = ServiceB()# service_b.pyfrom service_a import ServiceAclass ServiceB:    def __init__(self):        self.service_a = ServiceA()# 好的设计（依赖注入）# service_a.pyclass ServiceA:    def __init__(self, service_b=None):        self.service_b = service_b# service_b.pyclass ServiceB:    def __init__(self, service_a=None):        self.service_a = service_a# main.pyfrom service_a import ServiceAfrom service_b import ServiceBservice_b = ServiceB()service_a = ServiceA(service_b)service_b.service_a = service_a

# 完整的导入最佳实践示例#!/usr/bin/env python3# -*- coding: utf-8 -*-"""模块文档字符串"""# 标准库导入import osimport sysfrom datetime import datetimefrom typing import List, Optional# 第三方库导入import numpy as npimport pandas as pdfrom flask import Flask, jsonify# 本地模块导入from myapp.config import Configfrom myapp.models import User, Productfrom myapp.utils import helper_function# 定义模块的公开接口__all__ = ['process_data', 'DataProcessor']# 模块常量DEFAULT_TIMEOUT = 30# 模块类class DataProcessor:    pass# 模块函数def process_data(data: List[int]) -> Optional[float]:    pass# 模块入口if __name__ == "__main__":    pass