針對 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 引擎套件以維持相容性。您可以在這裡找到更多資訊。
在 1.x 中標記為舊型的 API 與節點在 Dynamo 4.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 設計。
這可以確保：
支援仍使用 .NET 8 並以 Revit 為主體的 Dynamo 版本
與使用 .NET 10 的單機版 Dynamo 4.x 相容
Last updated