正常情況下，我們想訪問字典中的某個值，都是通過中括號訪問，比如：

test_dict = {"test": {"imdb stars": 6.7, "length": 104}}

print(test_dict["test"]["imdb stars"])
# 104

而通過Box模塊，我們可以擴展字典功能，使用點符號訪問元素：

from box import Box

movie_box = Box({ "Robin Hood: Men in Tights": { "imdb stars": 6.7, "length": 104 } })

movie_box.Robin_Hood_Men_in_Tights.imdb_stars
# 6.7

另外，可以看到默認情況下轉換后，字典鍵值中的空格被轉化為了下劃線。

下面具體介紹 Box 模塊的使用方法。

1.準備

開始之前，你要確保Python和pip已經成功安裝在電腦上，如果沒有，可以訪問這篇文章：超詳細Python安裝指南 進行安裝。

**(可選1) **如果你用Python的目的是數據分析，可以直接安裝Anaconda：Python數據分析與挖掘好幫手—Anaconda，它內置了Python和pip.

**(可選2) **此外，推薦大家用VSCode編輯器，它有許多的優點：Python 編程的最好搭檔—VSCode 詳細指南。

請選擇以下任一種方式輸入命令安裝依賴 ：

1. Windows 環境 打開 Cmd (開始-運行-CMD)。
2. MacOS 環境 打開 Terminal (command+空格輸入Terminal)。
3. 如果你用的是 VSCode編輯器 或 Pycharm，可以直接使用界面下方的Terminal.

pip install --upgrade python-box[all]

2.基本使用

我們可以像文章開頭那樣傳入一個字典給 Box，生成一個Box對象；也可以直接使用參數賦值的方式生成一個Box對象：

from box import Box

my_box = Box(funny_movie='Hudson Hawk', best_movie='Kung Fu Panda')
my_box.funny_movie
# 'Hudson Hawk'

請記住，任何情況下，你往Box對象里添加字典或是數組，這些字典或數組都會被轉變為Box對象：

my_box = Box({"team": {"red": {"leader": "Sarge", "members": []}}})
print(my_box.team.red.leader)
# Sarge

my_box.team.blue = {"leader": "Church", "members": []}
print(repr(my_box.team.blue))
#

訪問列表中的 Box 對象也非常輕松：

my_box.team.red.members = [
    {"name": "Grif", "rank": "Minor Junior Private Negative First Class"},
    {"name": "Dick Simmons", "rank": "Captain"}
]

print(my_box.team.red.members[0].name)
# Grif

局限性

請注意，字典中有些默認方法，如： **clear, copy, fromkeys, get, items, keys, pop, popitem, setdefault, to_dict, update, merge_update, values ** ，當你的鍵值和這些方法名稱沖突時，你無法使用點符號訪問它們。

不過沖突時，你依然可以使用傳統的字典取值訪問它們，例如：

my_box['keys']

合并

要合并兩個Box對象，你只需要通過 merge_update 方法：

from box import Box

box_1 = Box(val={'important_key': 1})
box_2 = Box(val={'less_important_key': 2})

box_1.merge_update(box_2)

print(box_1)
# {'val': {'important_key': 1, 'less_important_key': 2}}

當然，你也可以用傳統的 update 方法：

from box import Box

box_1 = Box(val={'important_key': 1})
box_2 = Box(val={'less_important_key': 2})

box_1.update(box_2)

print(box_1)
# {'val': {'less_important_key': 2}}

轉換為原始列表/字典

如果你需要把一個 Box 對象的字典轉化為原始字典，.to_dict() 方法就可以幫你實現：

from box import Box

box_1 = Box(val={'important_key': 1})

print(box_1)
# {'val': {'less_important_key': 2}}
print(type(box_1))
# < class 'box.box.Box' >
print(type(box_1.to_dict()))
# < class 'dict' >

如果你需要把一個 Box 對象的列表轉化為原始列表，你可以使用 .to_list() 方法：

from box import BoxList

my_boxlist = BoxList({'item': x} for x in range(10))
# 

my_boxlist[5].item
# 5

print(type(my_boxlist.to_list()))
# < class 'list' >

3.導入導出功能

Box對象有一個很方便的功能，就是能夠輕松地將Box對象導出為 **Json / yaml / csv / msgpack **文件：

from box import BoxList

my_boxlist = BoxList({'item': x} for x in range(10))
# 

my_boxlist.to_json(filename="test.json")
# 在當前文件夾下生成一個 test.json 文件

此外，還能接受** Json / yaml / csv / msgpack **文件導入：

new_box = Box.from_json(filename="films.json")

各種類型的文件對應的方法如下：

• 不適用于 BoxList，僅適用于 Box ** 不適用于 Box，僅適用于 BoxList。