python模块以及导入出现ImportError: No module named 'xxx'问题

最新推荐文章于 2025-08-12 22:37:49 发布

转载最新推荐文章于 2025-08-12 22:37:49 发布 · 758 阅读

python 专栏收录该内容

29 篇文章

订阅专栏

本文详细介绍了Python中如何处理不同目录下的模块导入问题，包括修改sys.path、利用PYTHONPATH环境变量、放置于site_packages目录下等多种解决方案，并解释了常见的ImportError错误。

python中，每个py文件被称之为模块，每个具有__init__.py文件的目录被称为包。只要模
块或者包所在的目录在sys.path中，就可以使用import 模块或import 包来使用
如果你要使用的模块（py文件）和当前模块在同一目录，只要import相应的文件名就好，比
如在a.py中使用b.py：
import b

但是如果要import一个不同目录的文件(例如b.py)该怎么做呢？
首先需要使用sys.path.append方法将b.py所在目录加入到搜素目录中。然后进行import即
可，例如
import sys
sys.path.append('c:\xxxx\b.py') # 这个例子针对 windows 用户来说的
大多数情况，上面的代码工作的很好。但是如果你没有发现上面代码有什么问题的话，可要

注意了，上面的代码有时会找不到模块或者包（ImportError: No module named
xxxxxx），这是因为：
sys模块是使用c语言编写的，因此字符串支持 '\n', '\r', '\t'等来表示特殊字符。所以

上面代码最好写成：
sys.path.append('c:\\xxx\\b.py')
或者sys.path.append('c:/xxxx/b.py')
这样可以避免因为错误的组成转义字符，而造成无效的搜索目录（sys.path）设置。

sys.path是python的搜索模块的路径集，是一个list
可以在python 环境下使用sys.path.append(path)添加相关的路径，但在退出python环境后
自己添加的路径就会自动消失了！

3、搜索路径和路径搜索

模块的导入需要叫做“路径搜索”的过程。

搜索路径：查找一组目录

路径搜索：查找某个文件的操作

ImportError: No module named myModule

这种错误就是说：模块不在搜索路径里，从而导致路径搜索失败！

导入模块时，不带模块的后缀名，比如.py
Python搜索模块的路径：
1)、程序的主目录
2)、PTYHONPATH目录（如果已经进行了设置）
3)、标准连接库目录（一般在/usr/local/lib/python2.X/）
4)、任何的.pth文件的内容（如果存在的话）.新功能，允许用户把有效果的目录添加到模块搜索路径中去
.pth后缀的文本文件中一行一行的地列出目录。
这四个组建组合起来就变成了sys.path了，

>>> import sys
>>> sys.path
导入时，Python会自动由左到右搜索这个列表中每个目录。

关于 python ImportError: No module named 'xxx'的问题?
解决方法如下：
1. 使用PYTHONPATH环境变量，在这个环境变量中输入相关的路径，不同的路径之间用逗号
（英文的！)分开，如果PYTHONPATH 变量还不存在，可以创建它！
这里的路径会自动加入到sys.path中，永久存在于sys.path中而且可以在不同的python版本
中共享，应该是一样较为方便的方法。
C:\Users\Administrator\Desktop\test\module1.py:
def func1():
print("func1")

将C:\Users\Administrator\Desktop\test添加到PYTHONPATH即可直接import module1,然后

调用：module1.func1()即可。

2. 将自己做的py文件放到 site_packages 目录下

3. 使用pth文件，在 site-packages 文件中创建 .pth文件，将模块的路径写进去，一行一
个路径，以下是一个示例，pth文件也可以使用注释：
# .pth file for the my project(这行是注释)，命名为xxx.pth文件
C:\Users\Administrator\Desktop\test
这个不失为一个好的方法，但存在管理上的问题，而且不能在不同的python版本中共享。

4. 在调用文件中添加sys.path.append("模块文件目录")；
5. 直接把模块文件拷贝到$python_dir/Lib目录下。

通过以上5个方法就可以直接使用import module_name了。

参考文章：http://my.oschina.net/leejun2005/blog/109679