# 針對 Dynamo 4.x 更新套件與 Dynamo 資料庫
### 簡介
本部分包含將圖表、套件和資源庫移轉至 Dynamo 4.x 時，可能會遇到之問題相關資訊。Dynamo 4.0 引入：
* 顯著的效能改進
* 穩定性和錯誤修正更新
* 將程式碼庫現代化
* 移除先前在 1.x 中標記為舊型的 API
* 主要執行階段從 .NET 8 更新到 .NET 10
* PythonNet 3 現在是所有新 Python 節點的預設 Python 引擎
.NET 10 移轉工作確保 Dynamo 與 Microsoft 的技術路線圖保持一致，遠遠早於 2026 年 11 月 .NET 8 的終止支援。
當您啟動 Dynamo 4.0 時，系統會要求您更新至 .NET 10 (如果尚未更新)。套件作者必須將其專案更新為目標 .NET 10，以確保完全相容。
所有在 Dynamo 4.0+ 中建立的新 Python 節點都從 PythonNet3 開始。不須擔心向下相容性：對於在多版本產品 (例如，Revit 或 Civil 3D 2025/2026) 中工作的使用者，請在 Dynamo 3.3-3.6 中安裝 PythonNet3 引擎套件以維持相容性。您可以在[這裡](https://dynamobim.org/dynamo-core-4-0-release/)找到更多資訊。
在 1.x 中標記為舊型的 API 與節點在 Dynamo 4.0 中已移除。您可以參考[這裡完整的變更清單](https://github.com/DynamoDS/Dynamo/wiki/API-Changes-in-Dynamo-4.0.0)。
### 套件相容性
#### 在 Dynamo 4.x 中使用 Dynamo 2.x 和 3.x 套件
由於 Dynamo 4.x 現在於 .NET 10 執行階段執行，因此針對 Dynamo 2.x 建置的套件 (*使用 .NET48*) 和 Dynamo 3.x (*使用 .NET 8*) 不保證可在 Dynamo 4.x 中運作。嘗試在 Dynamo 4.x 中下載從低於 4.0 的 Dynamo 版本發佈的套件時，您會收到警告，指出套件來自舊版 Dynamo。
**這不表示套件無法運作**。這只是警告您可能有相容性問題。一般而言，建議您檢查是否有專為 Dynamo 4.x 建置的較新版本。
載入套件時，您也可能會在 Dynamo 記錄檔中看到此類警告。如果所有一切都正常運作，即可忽略警告。
#### 在 Dynamo 2.x 中使用 Dynamo 4.x 套件
針對 Dynamo 4.x 建置的套件 (*使用.Net 10*) 在 Dynamo 2.x 上很可能無法運作。當您嘗試在 Dynamo 2.x 中安裝針對 Dynamo 4.x 建置的套件時，您也會看到以下警告。
#### 在 Dynamo 3.x 中使用 Dynamo 4.x 套件
針對 Dynamo 4.x 建置的套件 (*使用 .NET 10*) 可能可以在 Dynamo 3.x 上運作 (但套件中使用的所有 API 都必須在 .NET 8 中)。但並不保證套件能夠運作。當您嘗試在 Dynamo 3.x 中安裝針對 Dynamo 4.x 建置的套件時，您也會看到以下警告。
#### 套件作者的最佳實踐
最佳實踐是修改 .csproj，將專案同時針對 .NET 8 和 .NET 10 設計。
```
net8.0;net10.0
```
這可以確保：
* 支援仍使用 .NET 8 並以 Revit 為主體的 Dynamo 版本
* 與使用 .NET 10 的單機版 Dynamo 4.x 相容
---
# 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/1_developer_primer_intro/3_developing_for_dynamo/6-2-updating-your-packages-and-dynamo-libraries-for-dynamo-4x.md?ask=
```
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.