[[438595]]

https://github.com/golang/exp/blob/master/maps/maps.go

01 真實的場景

不少新手，對 map 的輸出是隨機的有迷惑，曾經，map 的輸出順序是固定的，但官方怕大家依賴這個順序，之后故意讓輸出順序不固定。

但實際場景中，會有按某種順序輸出 map 的需求，怎么辦呢?這需要對 map 的 key 進行排序，偽代碼如下：

for k := m { 
  keys = append(keys, k) 
} 
sort(keys) 

類似的代碼會經常需要寫，關鍵是，因為沒有泛型，我們還沒法寫一個通用函數，復用代碼。

02 maps 包詳解

目前 maps 包有 8 個函數：

func Keys[M ~map[K]V, K comparable, V any](m M) []K 
func Values[M ~map[K]V, K comparable, V any](m M) []V 
func Equal[M1, M2 ~map[K]V, K, V comparable](m1 M1, m2 M2) bool 
func EqualFunc[M1 ~map[K]V1, M2 ~map[K]V2, K comparable, V1, V2 any](m1 M1, m2 M2, eq func(V1, V2) bool) bool 
func Clear[M ~map[K]V, K comparable, V any](m M) 
func Clone[M ~map[K]V, K comparable, V any](m M) M 
func Copy[M ~map[K]V, K comparable, V any](dst, src M) 
func DeleteFunc[M ~map[K]V, K comparable, V any](m M, del func(K, V) bool) 

其中 Keys 就是上面說的場景，提取出 map 中所有的 key，組成一個 slice，方便做排序。相應的，Values 函數就是獲取所有的 value，組成一個 slice。

func Keys[M ~map[K]V, K comparable, V any](m M) []K { 
 r := make([]K, 0, len(m)) 
 for k := range m { 
  r = append(r, k) 
 } 
 return r 
} 

留意類型約束：~map[K]V，表明只要底層類型是 map 就適用，即適用自定義的 map 類型。上面函數的類型約束還說明，map 中，key 必須是可比較的，即 comparable 的，而 value 可以是任意類型，即 any。

Equal 和 EqualFunc 用于比較兩個 map 是否有相同的鍵值對，用的應該不多。

至于 Clone 和 Copy，Clone 用于克隆出一個新的 map，key 和 value 和原來的一致，不過不是深度克隆，也就是說 value 可能指向同一個。

而 Copy 可以將 src 中的 key/value 全部復制到 dst 中，如果 dst 中存在同樣的 key，會覆蓋。

Clear 和 DeleteFunc 用于刪除 map 的鍵值對。

maps 包代碼不到 100 行，實現很簡單，很容易看懂。不過大家需要認真看懂函數的簽名，因為泛型的引入，導致函數簽名比之前的函數簽名復雜很多。

03 總結

PHPer 可能不以為然：這些東西，PHP 一直就有，Go 越來越 PHP 了。。。

之前 Go 沒有提供相關函數，主要是因為沒有泛型，沒法提供通用的函數。有了泛型，就可以寫通用代碼了，因此提供相關的便利函數。

關于 maps 包有什么建議，大家以后試用可以提建議，畢竟現在只是在 exp 包中，沒有正式合入標準庫。