python错误:module ‘shutil’ has no attribute ‘copy’

栏目: Python · 发布时间: 7年前

内容简介：python错误:module ‘shutil’ has no attribute ‘copy’

字符：5706

平移阅读时长：7分钟

今天在写一个小脚本来把自己写的一个html批量复制并在保持后缀不变的情况下随机命名。

先打算实现文件的拷贝。

Google了一下，发现了一个 shutil 的库(这个库的名字纠结了发音老半天，后面才理解是sh和util的结合，也就是shell-util)

这个库提供了与 shell 命令操作文件等同的所有方法： copy , copytree , rmtree , move …

代码实现

有了这个库，代码很容易就实现了：

import shutil

src = 'sa-jumper.html'

randomStr = 'ad239sdfasdl2asdf9adsfi23dfladf'
strLen = len(randomStr)

shutil.copy(src, 'tmp/aa.html')

关于随机的部分，就只是提前做了准备。先用的 shutil.copy 来测试文件拷贝功能。

然后我先用的 python3.6 执行了这个文件，结果报错：

Traceback (most recent call last):
  File "copy.py", line 2, in <module>
    import shutil
  File "/usr/local/Cellar/python3/3.6.0_1/Frameworks/Python.framework/Versions/3.6/lib/python3.6/shutil.py", line 13, in <module>
    import tarfile
  File "/usr/local/Cellar/python3/3.6.0_1/Frameworks/Python.framework/Versions/3.6/lib/python3.6/tarfile.py", line 49, in <module>
    import copy
  File "/Library/WebServer/Documents/xxx/copy.py", line 13, in <module>
    shutil.copy(src, 'tmp/aa.html')
AttributeError: module 'shutil' has no attribute 'copy'

后面改用 python2.7 执行，顺利通过。

debug

打开 Python 的解释器提示符，执行上述代码，也是成功的。

这下我就没辙了，感觉个人的Python经验只能到此为止，启用Google大法。

在StackOverflow的一篇文章上，发现有人遇到类似的问题，链接如下：

https://stackoverflow.com/questions/22131139/attributeerror-module-object-has-no-attribute-x

在上述链接里面，最终的错误是因为提问的人，python脚本的名称是 org.py 跟系统的一个文件重名，导致了一个错误的引用。

所以很自然的，我就联想到了我的文件，名字是 copy.py ，而看上面的错误信息里面，是用一个 import copy ，估计也是同样错误的把我的脚本当作官方库给错误引用了。

修复

把文件名改成了 copy-file.py ，再用 python3.6 执行，一切顺利。

分析

从这个错误里面想到几个问题：

为啥跟官方库里面的文件同名会导致引用错误
为啥python2.7没报错
如何避免这样的问题

关于引用错误

重新翻了一下之前看的《Python简明教程》

关于模块的索引

如果它不是一个已编译好的模块，即用 Python 编写的模块，那么 Python 解释器将从它的 sys.path 变量所提供的目录中进行搜索。如果找到了对应模块，则该模块中的语句将在开始运行，并能够为你所使用。在这里需要注意的是，初始化工作只需在我们第一次导入模块时完成。

关于索引的顺序

sys.path 内包含了导入模块的字典名称列表。你能观察到 sys.path 的第一段字符串是空的——这一空字符串代表当前目录也是 sys.path 的一部分，它与 PYTHONPATH 环境变量等同。这意味着你可以直接导入位于当前目录的模块。否则，你必须将你的模块放置在 sys.path 内所列出的目录中。

从这里可以看到，执行的脚本所在的目录也是在python搜索模块的范围内的，而且是第一位，也就是会优先搜索的，这也就是为啥同名会导致引用错误的原因了。

为啥2.7没错

按照上面StackOverflow那边文章的分析过程，我分别看了python3.6和python2.7版本里面 shutil.py 和 tarfile.py 源码，发现 shutil.py 都引用了 tarfile.py ，而 tarfile.py 也都 import copy

那就不可能是2.7里面没有引用copy了。

然后我又仔细的看了一下各自的实现，终于发现了问题，在2.7里面，不是在初始化的时候就import了tarfile，而是在一个 _make_tarball 的函数里面。

我在这个函数的 import tarfile 前面加了一个 print('import tarfile') ，再去执行刚刚的 copy.py (这块为了测试方便，把 copy-file.py 复制了一份重命名为 copy.py )。

发现没有print任何内容。

而在3.6里面，是在文件头部，一开始就import了tarfile。这也就解释了为啥2.7没问题，3.6有问题了。同时也说明： python的import是按需加载的 。写在函数里面的import，只有在函数被调用的时候才会真实的去import

为了反证这个推断是否有效，我找到了2.7里面shutil的一个会触发 import tarfile 的函数 make_archive

使用了官方提供的example:

import shutil
import os
archive_name = os.path.expanduser(os.path.join('~', 'myarchive'))
root_dir = os.path.expanduser(os.path.join('~', '.ssh'))
shutil.make_archive(archive_name, 'gztar', root_dir)

执行 python copy.py (我的环境里面，默认是2.7)

果然报错了：

import tarfile
import tarfile
Traceback (most recent call last):
  File "copy.py", line 20, in <module>
    shutil.make_archive(archive_name, 'gztar', root_dir)
  File "/usr/local/Cellar/python/2.7.13/Frameworks/Python.framework/Versions/2.7/lib/python2.7/shutil.py", line 561, in make_archive
    filename = func(base_name, base_dir, **kwargs)
  File "/usr/local/Cellar/python/2.7.13/Frameworks/Python.framework/Versions/2.7/lib/python2.7/shutil.py", line 376, in _make_tarball
    import tarfile  # late import so Python build itself doesn't break
  File "/usr/local/Cellar/python/2.7.13/Frameworks/Python.framework/Versions/2.7/lib/python2.7/tarfile.py", line 52, in <module>
    import copy
  File "/Library/WebServer/Documents/xxx/copy.py", line 20, in <module>
    shutil.make_archive(archive_name, 'gztar', root_dir)
  File "/usr/local/Cellar/python/2.7.13/Frameworks/Python.framework/Versions/2.7/lib/python2.7/shutil.py", line 561, in make_archive
    filename = func(base_name, base_dir, **kwargs)
  File "/usr/local/Cellar/python/2.7.13/Frameworks/Python.framework/Versions/2.7/lib/python2.7/shutil.py", line 394, in _make_tarball
    tar = tarfile.open(archive_name, 'w|%s' % tar_compression[compress])
AttributeError: 'module' object has no attribute 'open'

然后我尝试把文件名修改为 copy-file.py ，再执行，顺利通过。

看来2.7和3.6都是一样的索引模块的方式，只是因为 shutil 模块里面引用 tarfile 的方式不一样，才造成一开始的执行结果不一样。

如何避免这样的问题

我还是一个python新手，不知道python在命名的时候有没有提供一些合理的规范，比如不能使用的单词。

然后我又一次看了《简明Python教程》，里面关于标识符命名这块：

量是标识符的一个例子。标识符（Identifiers）是为某些东西提供的给定名称。在你命名标识符时，你需要遵守以下规则：

• 第一个字符必须是字母表中的字母（大写 ASCII 字符或小写 ASCII 字符或 Unicode 字符）或下划线（
）。
）、数字（0~9）组成。

• 标识符名称区分大小写。例如，myname 和 myName 并不等同。要注意到前者是小写字母 n 而后者是大写字母 N。

• 有效的标识符名称可以是 i 或 name_2_3 ，无效的标识符名称可能是 2things，this is spaced out，my-name 和 >a1b2_c3。

我想，如果我以非这个规范的方式定义文件名是不是就可以了。

然而用类似 import copy-file 的方式引用自己的模块，会报错， SyntaxError 。

也有看到有相关的解决方式：

python2.7 execfile('foo-bar.py')
python3.x exec(open(fn).read())

不过这些方法感觉都不是很自然，还是放弃这样的尝试了。

只能使用另一种方式了，就是统一文件名的前缀。如果你的项目是 foo ，那么可以给所有项目的文件定义以这个为前缀的名称: foo__copy.py , foo_shutil.py 等等。

这样只要 foo 是一个不会和常见的库的前缀重名的字符串，就能保证项目里面不会再发生这样的名称冲突了。

参考资料

突然发现，我只是想实现一个文件拷贝，咋就绕了这么远呢:sob:

以上所述就是小编给大家介绍的《python错误:module ‘shutil’ has no attribute ‘copy’》，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对码农网的支持！

查看所有标签

猜你喜欢:

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍

逻辑的引擎

[美] 马丁·戴维斯 / 张卜天 / 湖南科学技术出版社 / 2005-5 / 20.00元

本书介绍了现代计算机背后的那些基本概念和发展这些概念的人，描写了莱布尼茨、布尔、费雷格、康托尔、希尔伯特、哥德尔、图灵等天才的生活和工作，讲述了数学家们如何在成果付诸应用之前很久就已经提出了其背后的思想。博达著作权代理有限公司授权出版据美国W.W.Norton公司2000年版本译出。2007年第二版亦使用同一ISBN。一起来看看《逻辑的引擎》这本书的介绍吧!

码农工具