python -m module [arg]

使用python --help查看:
-m mod : run library module as a script(terminates option list)

有一些 Python 模块可以当作脚本使用，可以使用 python -m module [arg] ... 命令调用它们，这类似在命令行中键入完整的路径名执行模块源文件一样。

一、使用举例

1、python –m pip install

在windows中，如果想要在命令行里直接使用pip或easy_install, 需要将其所在目录scripts添加到系统环境变量path中，否则会提示错误，如下图：

1.png

但是可以使用python –m pip install , 相当于输入了pip的完整路径.

2.png

2、python -m json.tool调用json包里的tool模块，用来格式化JSON数据。

还有python -m pdb script.py、python -m profile script.py等。

二、区分python xxx.py 和 python -m xxx.py

python xxx.py 和 python -m xxx.py是两种加载python文件的方式:
python xxx.py叫做直接运行
python -m xxx.py把模块当作脚本来启动(注意：但是_ _name __ 的值为'main' )
不同的加载py文件的方式，主要是影响sys.path 这个属性.

sys.path 变量的初始值来自如下：

(1)输入脚本的目录（当前目录）。
(2)环境变量 PYTHONPATH 表示的目录列表中搜索(这和 shell 变量 PATH 具有一样的语法，即一系列目录名的列表)。
(3)Python 默认安装路径中搜索。

下面有两个例子，通过不同方式启动同一文件，sys.path属性的值有何不同。
run.py内容如下

import sys
print(sys.path)

(1)直接启动：

python run.py

运行结果如下：

 ['/search/odin/common', '/usr/local/python2713/lib/python2.7/site-packages/distribute-0.6.14-py2.7.egg', '/usr/local/python2713/lib/python2.7/site-packages/pip-9.0.1-py2.7.egg', '/usr/local/python2713/lib/python27.zip','/usr/local/python2713/lib/python2.7', '/usr/local/python2713/lib/python2.7/plat-linux2', '/usr/local/python2713/lib/python2.7/lib-tk', '/usr/local/python2713/lib/python2.7/lib-old','/usr/local/python2713/lib/python2.7/lib-dynload', '/search/odin/common/.local/lib/python2.7/site-packages', '/usr/local/python2713/lib/python2.7/site-packages', '/usr/local/python2713/lib/python2.7/site-packages/setuptools-0.6c11-py2.7.egg-info']

(2)以模块方式启动：

python -m run.py

运行结果如下：

 ['','/usr/local/python2713/lib/python2.7/site-packages/distribute-0.6.14-> py2.7.egg', '/usr/local/python2713/lib/python2.7/site-packages/pip-9.0.1-py2.7.egg', '/usr/local/python2713/lib/python27.zip', '/usr/local/python2713/lib/python2.7', '/usr/local/python2713/lib/python2.7/plat-linux2', '/usr/local/python2713/lib/python2.7/lib-tk', '/usr/local/python2713/lib/python2.7/lib-old', '/usr/local/python2713/lib/python2.7/lib-dynload', '/search/odin/common/.local/lib/python2.7/site-packages', '/usr/local/python2713/lib/python2.7/site-packages', '/usr/local/python2713/lib/python2.7/site-packages/setuptools-0.6c11-py2.7.egg-info']

从两次的运行结果可以看出直接启动是把run.py文件，所在的目录放到了sys.path属性中。
模块启动是把你输入命令的目录（也就是当前路径），放到了sys.path属性中

应用场合
目录结构如下：

package/ __init__.py 
         mod1.py
package2/ __init__.py
          run.py

run.py 内容如下：

import sys
from package import mod1
print(sys.path)

如何才能启动run.py文件？
1）直接启动（失败）

test_import_project git:(master) ✗ python package2/run.py
Traceback (most recent call last): 
    File "package2/run.py", line 2, in  
        from package import mod1
ImportError: No module named package

2）以模块方式启动（成功）

当需要启动的py文件引用了一个模块。需要注意：在启动的时候需要考虑sys.path中有没有import的模块的路径！这个时候，到底是使用直接启动，还是以模块的启动？目的就是把import的那个模块的路径放到sys.path中