Python:如何确保您的代码不会被您使用的库意外导入？

Question

几个小时前，我粗心大意，将我的短脚本命名为code.py。显然，有 such a package这是使用例如通过 ptvsd 或 pdb。这导致我的 code.py 被导入，并在尝试调试我的代码时导致一堆嵌套的未处理异常，缺少导入。更令人沮丧的是，回溯没有显示任何导入我的 code.py 文件的迹象，所以我花了很长时间才找到问题的根源。

我想避免将来出现这种情况，所以我的问题是:确保您使用的模块不会因此类名称冲突而错误地导入您的代码的最佳做法是什么？

Answer 1

这是一个常见的陷阱，实际上没有避免它的万无一失的方法。至少你可以确保你的模块都存在于包中(如果是一个没有可重用代码的小项目，至少有一个包)这样你就可以将它们用作 from mypackage import code 而不是 import code(还要确保你使用绝对导入等)，并且你总是从包含包的目录运行你的代码，而不是从包目录本身(python 插入当前工作目录在 sys.path 的第一个位置)。

这不会阻止所有可能的名称屏蔽问题，但应该将它们最小化。现在根据经验，一旦您至少遇到过一次此类问题，您通常会很快发现症状 - 最常见且非常明显的是一些完全不相关的 STLib 或第三方模块开始因 ImportErrors 或 AttributeErrors(与“模块 X 没有属性 Y”消息)。在这一点上，如果你只是在你自己的代码中添加了一个新模块，很可能是新模块破坏了一切，所以你可以重命名它(确保你清理了 .pyo/.pyc 文件，如果有的话)，看看是否它解决了这个问题。否则检查回溯以找出哪些导入失败，大多数情况下您会发现当前工作目录中有一个同名的模块或包。