为何`import mysql.connector`失效但`from mysql import connector`可行？

核心原因1：MySQL Connector/Python的包结构设计 #

MySQL官方的mysql-connector-python包的结构里，mysql包的__init__.py文件并没有显式导入connector子模块。这就导致：

• from mysql import connector是直接定位到connector模块并导入，绕开了mysql包的初始化逻辑，所以能成功。
• import mysql.connector需要先加载mysql包，再尝试访问它的connector属性，但因为__init__.py没提前导入这个子模块，Python找不到对应的属性，就会抛出错误。

核心原因2：Python模块导入的缓存机制 #

当你成功执行过from mysql import connector后，Python会把connector模块缓存到sys.modules字典里。之后哪怕你删掉这段导入代码，再使用connector时，Python会直接从缓存里读取已经加载好的模块，所以看起来“没有导入也能运行”。这是Python的默认优化，避免重复加载相同模块消耗资源。

额外排查点：本地命名冲突 #

如果你的项目目录下存在自己创建的mysql.py或mysql文件夹，会干扰Python的模块查找顺序。这种情况下：

• import mysql.connector会优先加载你本地的mysql模块/包，而它里面没有connector，所以报错。
• from mysql import connector可能因为路径优先级问题，偶然加载到了官方包，但这种情况比较少见，建议检查项目里有没有同名文件/文件夹，避免冲突。

解决建议 #

• 日常使用直接用from mysql import connector的方式，这是符合该包设计的标准导入方式。
• 如果一定要用import mysql.connector，可以手动先加载connector模块到mysql包的属性中：

  import mysql
  from mysql import connector
  # 之后即可正常使用mysql.connector
  

内容的提问来源于stack exchange，提问作者password is password