python -m

2025-09-27 181 阅读2分钟

在 Python 中，python -m 是一个非常有用的命令行参数，用于运行 Python 模块作为脚本。以下是关于 python -m 参数的详细介绍：

基本用法

python -m 的基本格式是：

python -m module_name [args]

module_name 是要运行的模块名。
[args] 是传递给模块的参数（如果有）。

作用

运行模块作为脚本：python -m 允许你将一个模块当作脚本运行。这在运行标准库中的模块或第三方模块时非常有用。
避免文件名冲突：如果你有一个与标准库模块同名的脚本文件，直接运行脚本可能会导致冲突。使用 python -m 可以避免这种问题。

示例

运行标准库模块：
- 运行 http.server 模块（Python 3 中的简单 HTTP 服务器）：
```
python -m http.server 8000
```
  这会在当前目录启动一个 HTTP 服务器，监听端口 8000。
运行第三方模块：
- 假设你安装了 requests 模块，你可以运行它的命令行工具：
```
python -m requests --help
```
运行自定义模块：
- 假设你有一个名为 my_module.py 的文件，内容如下：
```
# my_module.py
def main():
    print("Hello, world!")
if __name__ == "__main__":
    main()
```
  你可以使用以下命令运行它：
```
python -m my_module
```

注意事项

模块路径：python -m 会从 Python 的模块路径中查找模块。确保你的模块在 Python 的模块路径中（可以通过 sys.path 查看路径）。
模块必须有 __main__ 部分：要使模块能够作为脚本运行，模块中必须有 if __name__ == "__main__": 部分。
参数传递：传递给模块的参数会通过 sys.argv 传递给模块。

实际用途

运行测试：许多测试框架（如 unittest）可以通过 python -m 运行测试。
```
python -m unittest discover
```
运行工具：许多 Python 工具（如 pip）也是通过 python -m 运行的。
```
python -m pip install some_package
```

总之，python -m 是一个强大且灵活的工具，可以帮助你更方便地运行和管理 Python 模块。