如何阻止Python import时同时导入文件名作为模块名？

为什么stuff会出现在dir(module)中？ #

当你执行from . import stuff as othername时，Python的执行逻辑是：

1. 找到并加载stuff模块，将其添加到当前包（module）的命名空间中，键为'stuff'
2. 再在命名空间中添加一个新的键'othername'，指向同一个stuff模块对象
   所以最终包的命名空间里同时存在stuff和othername两个指向同一模块的引用，这就是dir()会显示它的原因。

如何只保留别名，移除原模块名？ #

你尝试的del stuff是完全可行的方案，而且是符合Python惯用写法的。修改后的__init__.py如下：

from . import stuff as othername
from . import stuff as aliasname
# 删除原模块名的引用
del stuff

这样操作后，dir(module)就只会显示othername和aliasname，不会再出现stuff了。这个方式是可靠的——你只是从包的命名空间中移除了stuff这个名称，模块本身已经被加载到内存中，别名的引用依然有效，不会影响使用。

另外补充：__all__的作用是控制from module import *时会导入哪些名称，它不会影响dir()的输出结果，所以你之前添加__all__的方式无法隐藏stuff，这是正常的。

为同一模块设置多个别名的最佳实践 #

你的两种写法都是可行的，但更简洁清晰的方式有两种：

• 先导入一个别名，再赋值其他别名：

from . import stuff as othername
aliasname = othername
del stuff

这种方式减少了重复的模块查找操作（虽然模块会被Python缓存，性能影响可以忽略，但写法上更简洁）。

• 一次性导入多个别名，再删除原名称：

from . import stuff as othername, stuff as aliasname
del stuff

这种写法更直观，能一眼看出多个别名都是指向同一个模块的。

两种方式都是Python社区认可的“正确”写法，选择哪种取决于你的代码风格偏好，只要保持代码清晰易读就好。

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