[TOC] ### 使用方式 Python本身就內置了很多非常有用的模塊，只要安裝完畢，這些模塊就可以立刻使用。 ###標準模板 我們以內建的`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! $ python hello.py Michael Hello, Michael! ~~~ 如果啟動Python交互環境，再導入`hello`模塊： ~~~ $ python3 Python 3.4.3 (v3.4.3:9b73f1c3e601, Feb 23 2015, 02:52:03) [GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> 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`等； 之所以我們說，`privat`e函數和變量“不應該”被直接引用，而不是“不能”被直接引用，是因為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`。