摘抄：https://www.liaoxuefeng.com/wiki/0014316089557264a6b348958f449949df42a6d3a2e542c000/001431845183474e20ee7e7828b47f7b7607f2dc1e90dbb000

本文章完全用於個人復習使用，侵刪；

我們以內建的sys模塊為例，編寫一個hello的模塊：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

‘ a test module ‘

__author__ = ‘Michael Liao‘

import sys

def test():
    args 
 
= sys.argv
    if len(args)==1:
        print(‘Hello, world!‘)
    elif len(args)==2:
        print(‘Hello, %s!‘ % args[1])
    else:
        print(‘Too many arguments!‘)

if __name__==‘__main__‘:
    test()

第1行和第2行是標準註釋，第1行註釋可以讓這個hello.py文件直接在Unix/Linux/Mac上運行，第2行註釋表示.py文件本身使用標準UTF-8編碼；

第4行是一個字符串，表示模塊的文檔註釋，任何模塊代碼的第一個字符串都被視為模塊的文檔註釋；

第6行使用__author__變量把作者寫進去，這樣當你公開源代碼後別人就可以瞻仰你的大名；

以上就是Python模塊的標準文件模板，當然也可以全部刪掉不寫，但是，按標準辦事肯定沒錯。

後面開始就是真正的代碼部分。

你可能註意到了，使用sys模塊的第一步，就是導入該模塊：

import sys

導入sys模塊後，我們就有了變量sys指向該模塊，利用sys這個變量，就可以訪問sys模塊的所有功能。

sys模塊有一個argv變量，用list存儲了命令行的所有參數。argv至少有一個元素，因為第一個參數永遠是該.py文件的名稱，例如：

運行python3 hello.py

獲得的sys.argv就是[‘hello.py‘]；

運行python3 hello.py Michael獲得的sys.argv就是[‘hello.py‘, ‘Michael]。

最後，註意到這兩行代碼：

if __name__==‘__main__‘:
    test()

當我們在命令行運行hello模塊文件時，Python解釋器把一個特殊變量__name__置為__main__，而如果在其他地方導入該hello模塊時，if判斷將失敗，因此，這種if測試可以讓一個模塊通過命令行運行時執行一些額外的代碼，最常見的就是運行測試。

我們可以用命令行運行hello.py看看效果：

$ python3 hello.py
Hello, world!
$ python3 hello.py Michael
Hello, Michael!

如果啟動Python交互環境，再導入hello模塊：

>>> import hello
>>>

導入時，沒有打印Hello, word!，因為沒有執行test()函數。

調用hello.test()時，才能打印出Hello, word!

>>> hello.test()
Hello, world!

作用域

在一個模塊中，我們可能會定義很多函數和變量，但有的函數和變量我們希望給別人使用，有的函數和變量我們希望僅僅在模塊內部使用。在Python中，是通過 _ 前綴來實現的。

正常的函數和變量名是公開的（public），可以被直接引用，比如：abc，x123，PI 等；

類似__xxx__這樣的變量是特殊變量，可以被直接引用，但是有特殊用途，比如上面的__author__，__name__就是特殊變量，hello模塊定義的文檔註釋也可以用特殊變量__doc__訪問，我們自己的變量一般不要用這種變量名；

類似_xxx和__xxx這樣的函數或變量就是非公開的（private），不應該被直接引用，比如_abc，__abc等；

之所以我們說，private函數和變量“不應該”被直接引用，而不是“不能”被直接引用，是因為Python並沒有一種方法可以完全限制訪問private函數或變量，但是，從編程習慣上不應該引用private函數或變量。

private函數或變量不應該被別人引用，那它們有什麽用呢？請看例子：

def _private_1(name):
    return ‘Hello, %s‘ % name

def _private_2(name):
    return ‘Hi, %s‘ % name

def greeting(name):
    if len(name) > 3:
        return _private_1(name)
    else:
        return _private_2(name)

我們在模塊裏公開greeting()函數，而把內部邏輯用private函數隱藏起來了，這樣，調用greeting()函數不用關心內部的private函數細節，這也是一種非常有用的代碼封裝和抽象的方法，即：

外部不需要引用的函數全部定義成private，只有外部需要引用的函數才定義為public。

Python學習筆記（十二） 使用模塊