Python中导入自定义工具模块的问题如何解决?

前几天更新了 autopep8,发现它更新了关于 E402 的部分,也就是 import 要在文件的最前面。

之前使用了一个自定义模块,是个通用工具,好几个项目用到,用 sys.path.append 导入的:

# 添加目录 导入自定义模块
if os.name == 'nt':
    root = 'D:/OneDrive/'  # PC
else:
    root = '/Users/Name/OneDrive/'  # MAC
sys.path.append(root + 'Python/')
from my_toolbox import *

这个其实违反了 E402, import 在下面了。

然后需求是:

  • 尽量遵守 pep8,不要 ignore 错误提示。
  • 这个包我想放在网盘目录下,不想放在 python 目录里。
  • 也不要用 mklink 之类的邪道……

有啥简便的解决方案嘛?
刚在 win 下试了添加该目录到环境变量,好像无效。


Python中导入自定义工具模块的问题如何解决?

7 回复

1.你另做一个包 a,然后安装了。在 a 里面做这些事情。
2.分别修改系统变量。


在Python里导入自定义模块,最常见的问题就是Python解释器找不到你的模块文件。这通常是因为模块不在Python的搜索路径里。

核心解决方法就一个:确保你的模块文件所在的目录在 sys.path 这个列表里。

下面是一个典型项目结构和两种最实用的导入方法:

假设你的项目结构是这样的:

my_project/
├── utils/
│   └── my_tools.py  # 你的自定义模块
└── main.py          # 主程序

方法一:使用相对导入(推荐用于包内)my_tools.py 里定义个函数:

# utils/my_tools.py
def greet(name):
    return f"Hello from tools, {name}!"

main.py 里这样导入:

# main.py
from utils.my_tools import greet

print(greet("Developer"))

方法二:直接修改 sys.path(适合快速测试) 如果上面的方法不行,你可以在 main.py 开头手动添加路径:

# main.py
import sys
import os
# 将 utils 的父目录(即项目根目录)添加到路径
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))

from utils.my_tools import greet
print(greet("Developer"))

关键检查点:

  1. 确认 utils 文件夹里有没有 __init__.py 文件(可以是空的)。在Python 3.3+后,对于简单情况这不是必须的,但有了它Python才会把文件夹当作一个“包”来处理,通常更规范。
  2. 别把你的脚本文件命名为 utils.py 这种和标准库或第三方库重名的名字,会冲突。
  3. 在终端里,确保你在 my_project 目录下运行 python main.py,而不是在别的目录。

一句话总结: 让Python能找到你的模块文件,要么把它放在正确的包结构里,要么直接告诉Python路径在哪。

就是不想做包。
请问修改系统变量怎么搞?我把 D:/OneDrive/Python/,也就是模块所在路径,加入 path,好像无法调用。

我不知道你用没用 Python 的虚拟环境, 如果用了的话, 可以把你之前做的 tools 模块放到 venv/lib/python/site-packages 下面.
推荐是用 ln -s 做一个软连接, 这样如果你想改动那个 tools 模块, 就只需要改一次, 不需要到处改了.

嗯,软链的确考虑过,不过也还是有诸多不便,所以直接 sys append 了。
如果用软链,那还是直接做个包链到 python 安装目录下面比较一劳永逸。
也算是备选方案吧,看看有没有更简单粗暴的。

[python - PEP8 – import not at top of file with sys.path - Stack Overflow]( https://stackoverflow.com/questions/36827962/pep8-import-not-at-top-of-file-with-sys-path/36829884)
感覺這兜圈子的搞法,好像還不如裝包然後軟鏈。

用.pth 文件指示包的路径

回到顶部