# 什麼是字典

Dynamo 2.0 引入將字典資料類型與清單資料類型分開的概念。此變更可能會對您如何在工作流程中建立和使用資料造成一些重大變更。在 2.0 版之前，字典和清單合併成一種資料類型。簡單來說，清單實際上是有整數鍵的字典。

### **什麼是字典？**

字典是一種由鍵 - 值對的集合所組成的資料類型，其中每個鍵在每個集合中都是唯一的。字典沒有順序，基本上您可以使用鍵值而不是清單中的索引值「查詢」內容。*在 Dynamo 2.0 中，鍵只能是字串。*

### **什麼是清單？**

清單是一種由有序值的集合所組成的資料類型。在 Dynamo 中，清單使用整數做為索引值。

### **進行此變更的原因，以及我為什麼需要關心？**

將字典與清單分開，是為了讓字典成為頭等物件，您可以使用它們快速輕鬆地儲存和查詢值，無需記住索引值或在整個工作流程中維護嚴格的清單結構。在使用者測試期間，我們看到當使用字典而不是數個 `GetItemAtIndex` 節點時，很明顯縮小了圖表大小。

### **有哪些變更？**

* \_語法\_發生了變化，改變您在 Code Block 中初始化和使用字典與清單的方式。
  * 字典使用以下語法 `{key:value}`
  * 清單使用以下語法 `[value,value,value]`
* 資源庫引入了 *新節點*，以協助您建立、修改和查詢字典。
* 在 1.x 版的 Code Block 中建立的清單，在載入腳本時會自動移轉成使用方括號 `[ ]` 而不是大括號 `{ }` 的新清單語法 \\

!

***

### **我為什麼需要關心？使用這些的目的是什麼？**

在電腦科學中，字典 (像是清單) 是物件的集合。清單有特定的順序，而字典則是 *沒有順序* 的集合。字典不依賴有順序的數字 (索引)，而是使用 *鍵*。

在下面的影像中，我們示範字典的可能使用案例。字典通常是用來讓兩組可能沒有直接關聯的資料建立關係。在我們的範例中，我們要將西班牙版本的某個字連接到英文版本，以供稍後進行查詢。

!

> 1. 建置字典以關聯兩個資料。
> 2. 取得具有給定索引的值。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://primer2.dynamobim.org/zh-tw/5_essential_nodes_and_concepts/5-5_dictionaries-in-dynamo/1-what-is-a-dictionary.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.