我在尝试编写一个可以作为模块或可执行脚本加载的python文件时遇到了类似的问题。

安装程序

/path/to/project/
├── __init__.py
└── main.py
    └── mylib/
        ├── list_util.py
        └── args_util.py

具有：

main.py：

#!/usr/bin/env python3
import sys
import mylib.args_util

if __name__ == '__main__':
    print(f'{mylib.args_util.parseargs(sys.argv[1:])=}')

mylib/list_util.py：

def to_int_list(args):
    return [int(x) for x in args]

mylib/args_util.py：

#!/usr/bin/env python3
import sys
from . import list_util as lu

def parseargs(args):
    return sum(lu.to_int_list(args))

if __name__ == '__main__':
    print(f'{parseargs(sys.argv[1:])=}')

输出

$ ./main.py 1 2 3
mylib.args_util.parseargs(sys.argv[1:])=6

$ mylib/args_util.py 1 2 3
Traceback (most recent call last):
  File "/path/to/project/mylib/args_util.py", line 10, in <module>
    from . import list_util as lu
ImportError: attempted relative import with no known parent package

解决方案

我决定使用Bash/Python多语言解决方案。Bash版本的程序只调用python3-m mylib.args_util，然后退出。

Python版本忽略Bash代码，因为它包含在docstring中。

Bash版本忽略Python代码，因为它使用exec停止解析/运行行。

mylib/args_util.py：

#!/bin/bash
# -*- Mode: python -*-
''''true
exec /usr/bin/env python3 -m mylib.args_util "$@"
'''

import sys
from . import list_util as lu

def parseargs(args):
    return sum(lu.to_int_list(args))

if __name__ == '__main__':
    print(f'{parseargs(sys.argv[1:])=}')

输出

$ ./main.py 1 2 3
mylib.args_util.parseargs(sys.argv[1:])=6

$ mylib/args_util.py 1 2 3
parseargs(sys.argv[1:])=6

解释

第1行：#/bin/bash；这是“shebang”线；它告诉交互式shell如何运行该脚本。Python:忽略（注释）Bash：忽略（注释）第2行：#-*-模式：python-*-可选；这被称为“模式线”；它告诉Emacs使用Python语法高亮显示，而不是在读取文件时猜测语言是Bash。Python:忽略（注释）Bash：忽略（注释）第3行：“”“truePython:将其视为以“true”开头的未分配文档字符串\nBash：将其视为三个扩展为true的字符串（其中前两个是空字符串）（即“+”+“true”=“true”）；然后它运行为true（它什么都不做）并继续到下一行第4行：exec/usr/bin/env python3-m mylib.args_util“$@”Python：仍然将其视为第3行中文档字符串的一部分。Bash：运行python3-m mylib.args_util，然后退出（它不会分析超出这一行的任何内容）第5行：“”Python：将其视为第3行中文档字符串的结尾。Bash：不解析此行

注意事项

这在Windows上不起作用：解决方法：使用WSL或批处理包装脚本调用python-m mylib.args_util。仅当当前工作目录设置为/path/to/project/时，此操作才有效。解决方法：调用/usr/bin/env时设置PYTHONPATH#!/bin/bash#-*-模式：python-*-“”“真的执行/usr/bin/env python3\PYTHONPATH=“$（cd”$（dirname“$0”）/。。“；pwd）”\-m mylib.args_util“$@”'''

太长，读不下去了通过在python脚本的入口点添加以下内容，将脚本路径附加到系统路径。

import os.path
import sys
PACKAGE_PARENT = '..'
SCRIPT_DIR = os.path.dirname(os.path.realpath(os.path.join(os.getcwd(), os.path.expanduser(__file__))))
sys.path.append(os.path.normpath(os.path.join(SCRIPT_DIR, PACKAGE_PARENT)))

现在，您可以在PyCharma和Terminal中运行项目了！！

我尝试了以上所有方法，但都没有效果，结果发现我的包名中错误地包含了-。

简而言之，在__init__.py所在的目录中不要有-。在发现这样的无意义之后，我从未感到欢欣鼓舞。

我为Python创建了一个新的实验性导入库：ultraimport

它使程序员能够对导入进行更多的控制，并使其明确无误。此外，当导入失败时，它还会提供更好的错误消息。

它允许您执行相对的、基于文件系统的导入，无论您如何运行代码，也无论您当前的工作目录是什么，这些导入始终有效。运行脚本或模块并不重要。您也不必更改sys.path，这可能会产生其他副作用。

然后你会改变

from .mymodule import myfunction

to

import ultraimport
myfunction = ultraimport('__dir__/mymodule.py', 'myfunction')

这样，即使您将代码作为脚本运行，导入也始终有效。

像这样导入脚本时的一个问题是，后续的相对导入可能会失败。ultraimport有一个内置的预处理器来自动重写相关的导入。

我的样板，以使包中的模块具有可独立运行的相对导入。

包/模块.py

## Standalone boilerplate before relative imports
if __package__ is None:                  
    DIR = Path(__file__).resolve().parent
    sys.path.insert(0, str(DIR.parent))
    __package__ = DIR.name

from . import variable_in__init__py
from . import other_module_in_package
...

现在，您可以以任何方式使用模块：

照常运行模块：python-m package.module将其用作模块：python-c“来自包导入模块”独立运行：python package/module.py或者使用shebang（#！/bin/env-python）：package/module.py

NB！如果模块与包同名，则使用sys.path.append而不是sys.path.insert将导致难以跟踪的错误。例如my_script/my_script.py

当然，如果您的包层次结构中有较高级别的相对导入，那么这是不够的，但在大多数情况下，这是可以的。

希望这对外面的人来说是有价值的——我浏览了六篇stackoverflow的帖子，试图找出与上面帖子类似的相对进口。我按照建议设置了所有内容，但仍在运行ModuleNotFoundError：没有名为“my_module_name”的模块

由于我只是在本地开发并四处游玩，所以我没有创建/运行setup.py文件。我显然也没有设置我的巨蟒。

我意识到，当我像以前一样运行代码时，当测试与模块位于同一目录中时，我找不到模块：

$ python3 test/my_module/module_test.py                                                                                                               2.4.0
Traceback (most recent call last):
  File "test/my_module/module_test.py", line 6, in <module>
    from my_module.module import *
ModuleNotFoundError: No module named 'my_module'

然而，当我明确指定路径时，事情就开始工作了：

$ PYTHONPATH=. python3 test/my_module/module_test.py                                                                                                  2.4.0
...........
----------------------------------------------------------------------
Ran 11 tests in 0.001s

OK

因此，如果有人尝试了一些建议，认为他们的代码结构正确，但仍然发现自己处于与我类似的情况，如果您不将当前目录导出到PYTHONPATH，请尝试以下任一操作：

运行代码并显式包含如下路径：$PYTHONPATH=。python3测试/my_module/模块测试.py为了避免调用PYTHONPATH=。，创建一个包含如下内容的setup.py文件，并运行python setup.py开发，将包添加到路径中：

#设置.py从setuptools导入安装程序，find_packages设置(name=“示例”，packages=find_packages（）)