使用python -m调用Python脚本失败的原因咨询

问题背景 #

项目目录结构如下：

drf/
├─ backend/
├─ py_client/
│  ├─ basic.py
├─ venv/
├─ requirements.txt

在虚拟环境中尝试不同命令运行basic.py，出现以下结果：

• 方法1：执行python -m py_client/basic.py，触发ModuleNotFoundError，提示改用py_client/basic；
• 方法2：执行python -m py_client/basic，仍报错找不到模块；
• 方法3：执行python py_client/basic.py，成功输出"It's working"；
• 方法4：执行python py_client/basic，提示文件不存在。

已知方法3、4的原因，以下是方法1、2失败的具体解析：

核心逻辑：python -m 按模块名而非文件路径解析 #

python -m的作用是让Python把目标当作模块导入并执行，它遵循Python的模块查找规则，和直接指定文件路径运行的逻辑完全不同。

方法1失败的原因 #

python -m接收的参数是模块名，不是文件名，所以不能带.py后缀。你输入的py_client/basic.py会被Python当作一个完整的模块名来查找，自然找不到对应的模块，因此报错提示你去掉.py后缀。

方法2失败的原因 #

你用了文件路径的分隔符/来指定层级，但Python的模块名是用**点.**来分隔包和子模块的。当你执行python -m py_client/basic时，Python会把py_client/basic当作一个单独的模块名，而不是py_client包下的basic模块，当然找不到。

另外，要让py_client被识别为可导入的包，在Python 3.3+中可以不需要__init__.py文件，但必须确保当前工作目录（也就是drf/）在Python的模块搜索路径sys.path中（默认情况下当前工作目录会被加入sys.path）。

正确的-m运行方式 #

如果想用python -m成功运行，只需把命令改成：

python -m py_client.basic

用点.分隔包和子模块的层级，Python就能正确找到py_client包下的basic模块并执行。

内容的提问来源于stack exchange，提问作者confused_nomad