python命名冲突主要源于模块、变量、函数或类名重复，应遵循pep 8规范：模块名用小写加下划线（如data_processor.py），避免与标准库或第三方包同名；导入时用as重命名（如import pandas as pd）；慎用from module import *，改用__all__控制公开接口；通过包结构和相对导入实现命名空间隔离。
Python命名冲突主要源于模块、变量、函数或类名重复，尤其在导入多个模块或使用第三方库时容易发生。避免冲突的关键是遵循清晰的命名规范，并合理利用Python的命名空间机制。
模块名用小写加下划线（snake_case）
PEP 8明确建议模块名应全部小写，必要时用下划线分隔单词，例如 data_processor.py、api_client.py。避免使用大写字母、连字符或空格——像 DataProcessor.py 或 my-module.py 会导致导入失败或跨平台问题。
- 模块名不与标准库重名（如不要命名为 json.py、os.py）
- 项目内自定义模块避免和常用第三方包同名（如 requests.py 会覆盖
pip install requests） - 包名也遵循同样规则，且不应使用下划线开头（如 _utils 易被误认为私有模块）
导入时用 as 显式重命名
当两个模块提供相似功能（比如都含 load() 函数），或名字过长/易冲突，可用 as 创建别名：
Python之模块学习 中文WORD版
下载
本文档主要讲述的是Python之模块学习；python是由一系列的模块组成的，每个模块就是一个py为后缀的文件，同时模块也是一个命名空间，从而避免了变量名称冲突的问题。模块我们就可以理解为lib库，如果需要使用某个模块中的函数或对象，则要导入这个模块才可以使用，除了系统默认的模块（内置函数）不需要导入外。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
-
import pandas as pd和import numpy as np是通用惯例 -
from myproject.utils import config as project_config避免和内置 config 混淆 - 慎用
from module import *—— 它会把所有公有名称导入当前命名空间，极易引发覆盖和调试困难
用 __all__ 控制公开接口
在模块末尾定义 __all__ 列表，显式声明哪些名称可通过 from module import * 导入。这不仅减少意外导入，也提升模块可维护性：
立即学习“Python免费学习笔记（深入）”；
__all__ = ["DatabaseClient", "connect", "query"]- 未列在 __all__ 中的函数、变量默认视为“内部实现”，即使没加下划线前缀也不会被星号导入
- 配合下划线前缀（如 _helper()）强化私有意图，但真正起作用的是 __all__
包结构隔离 + 相对导入辅助
大型项目推荐用包组织代码，通过层级天然隔离命名空间。例如：
-
app/models/user.py和app/services/user.py各自独立，调用时用完整路径：from app.models.user import User - 包内模块间可用相对导入（
from . import utils或from ..config import settings），避免硬编码顶层包名，降低重命名成本 - 确保每个包目录下有 __init__.py（哪怕为空），否则Python不识别为包
