Flow CLI（Dapper Labs）

什麼是 Flow CLI？

Flow CLI 是用於開發應用程式及與 Flow 區塊鏈互動的官方命令列介面。

CLI 是 command-line interface（命令列介面）的縮寫，意思是開發者在終端機輸入文字指令來操作工具，而非在圖形化應用程式中點擊按鈕。

Flow CLI 可初始化區塊鏈專案、執行本機 Flow 網路、測試 Cadence 程式碼、部署智能合約、傳送交易、執行指令碼、管理帳戶、產生金鑰、安裝合約相依項目，以及擷取區塊鏈資料。

此工具為本機 Flow Emulator、Flow Testnet 及 Flow Mainnet 提供一致的開發流程。

Flow CLI 主要供智能合約開發者、去中心化應用程式團隊、基礎設施工程師、測試人員及其他在 Flow 上建置產品的技術使用者使用。

Flow CLI 不是加密貨幣、加密貨幣錢包、區塊鏈節點、消費者應用程式或交易產品。

它是與 Flow Access Nodes 及本機開發服務通訊的開發者軟體。

Flow CLI 官方文件將其描述為透過單一介面管理專案、帳戶、合約、交易、相依項目及區塊鏈查詢的工具。

Flow CLI 與 Dapper Labs 有什麼關係？

Flow 最初由 Dapper Labs 設計與開發，因此有時會有人搜尋「Flow CLI Dapper Labs」。

Dapper Labs 建立 Flow，目標是支援能服務大量消費者的區塊鏈應用程式，同時避免所有應用程式都必須競爭有限的處理資源。

Flow 與 Cadence 的官方沿革指出，Dapper Labs 是該區塊鏈最初的設計者與開發者。

目前 Flow CLI 由 Onflow 組織以開放原始碼軟體形式發佈，是 Flow 開發者生態系的一部分。

此工具的官方原始碼儲存庫以 Apache 2.0 授權公開提供。

因此，Flow CLI 應被視為 Flow 網路的官方工具，而非僅由 Dapper Labs 內部營運的私人消費者應用程式。

Flow CLI 的最新版本是什麼？

截至 2026 年 7 月 14 日，最新發佈的 Flow CLI 版本為 2.17.4。

版本 2.17.4 於 2026 年 6 月 4 日發佈，並將工具更新至 Cadence 版本 1.10.3。

此版本也更新了隨附的 Flow 核心合約元件，使其相容於 Cadence 1.10.3。

開發者可透過Flow CLI 官方版本發佈頁面確認目前版本。

版本資訊可能頻繁變動，因為 CLI 必須與新的 Cadence 版本、模擬器更新、核心合約、網路功能及安全修補程式保持相容。

開發者可在終端機執行

，查看本機安裝的版本。

正式環境團隊應在自動化建置系統中使用經測試並固定的 CLI 版本，而非每次部署時都自動變更版本。

Flow CLI 為什麼重要？

區塊鏈開發不只是編寫智能合約檔案。

開發者還必須建立帳戶、管理金鑰、解析合約地址、提交已簽署交易、檢查結果、測試失敗情況，並將程式碼部署至正確網路。

Flow CLI 將這些工作整合到一致的工具中。

對於日常開發作業，此工具可減少手動向 Flow Access Nodes 建立原始請求的需求。

CLI 也讓指令可以重複執行，因此有利於測試、部署指令碼、持續整合及團隊協作。

將指令儲存在部署指令碼中，便可檢查並在多個開發環境中一致執行。

這比完全依賴未記錄的圖形介面手動操作更安全。

如何安裝 Flow CLI

Flow CLI 可安裝於 macOS、Windows 及大多數 Linux 系統。

由於可用的二進位檔及支援的作業系統版本可能變動，開發者應依照Flow CLI 官方安裝說明操作。

在 macOS 上，常見的安裝指令為

。

通常可使用

更新 Homebrew 安裝的版本。

官方也提供適用於支援的 Linux、macOS 及 Windows 環境的安裝指令碼。

以提升的系統權限執行安裝指令碼前，開發者應先檢查內容。

直接從未經驗證的網站或社群媒體訊息安裝軟體，可能讓電腦、私鑰及專案檔案暴露於惡意程式碼風險中。

安裝完成後，開發者應執行

與 ，確認執行檔正常運作且可透過系統路徑存取。

如何開始 Flow 專案

建立 Flow 專案的主要指令是

。

此指令會建立專案架構，並產生名為

的中央設定檔。

目前版本的 Flow CLI 可提供不同類型應用程式的專案範本，包括基本 Cadence 專案及較專門的區塊鏈工作流程。

範本可能包含智能合約、交易、指令碼、測試及專案設定的目錄。

官方專案初始化指南說明

如何建立新開發環境所需的檔案。

開發者應檢查產生的專案，不應假設所有預設設定都適合正式環境。

提交鏈上交易前，應確認網路地址、帳戶別名、相依項目、簽署者設定及部署目標。

什麼是 flow.json？

是 Flow CLI 使用的中央設定檔。

此檔案會描述 CLI 應使用的網路、帳戶、合約、相依項目、部署目標及專案路徑。

flow.json 官方設定參考文件說明可用的區塊與格式。

區塊會定義與模擬器、測試網及主網等環境的連線。

區塊會將易讀的帳戶名稱對應至 Flow 地址及簽署金鑰設定。

區塊會將 Cadence 合約名稱對應至原始碼檔案及各網路專用地址。

區塊會指定各網路上的哪些帳戶應部署哪些合約。

妥善維護設定檔，可讓相同的 Cadence 匯入項目在模擬器、測試網及主網解析至不同地址。

如此可避免開發者在每個原始碼檔案中都寫死某個網路的合約地址。

團隊應透過版本控制檢查

的變更，因為部署目標或帳戶別名遭修改後，可能導致交易送往錯誤環境。

flow.json 會儲存私鑰嗎？

Flow CLI 支援包含私鑰資訊的設定，但將未加密的正式環境金鑰直接放入共用的

檔案中非常危險。

私鑰持有者可依金鑰權重及帳戶設定，授權相關 Flow 帳戶進行區塊鏈交易。

若設定檔上傳至公開儲存庫，攻擊者可能控制合約、代幣及管理權限。

目前 Flow CLI 的設定方式包括直接輸入十六進位金鑰、外部金鑰檔案、以助記詞推導金鑰及整合 Google Cloud KMS。

使用外部金鑰管理系統可減少原始簽署資料暴露於本機專案檔案中的需求。

金鑰檔案、環境專用設定及其他機密資訊都應排除於公開版本控制之外。

開發者也應將模擬器金鑰與測試網及主網金鑰分開。

模擬器的預設服務金鑰是公開已知的；只有因模擬器屬於不含真實資產的本機開發網路，才適合使用此金鑰。

Flow CLI 可以使用哪些網路？

Flow CLI 可與本機 Flow Emulator、Flow Testnet、Flow Mainnet 及自訂 Flow Access Node 端點互動。

模擬器供私人本機開發使用。

測試網是公開環境，可用於測試應用程式，且不必使用正式環境的 Flow 資產。

主網是正式區塊鏈，交易可能影響真實帳戶、已部署合約及加密資產。

許多指令接受

選項，用於指定目標環境。

例如，開發者可使用

、 或 。

若未指定或確認網路，部署或交易可能會送往非預期的環境。

正式環境指令碼應明確指定網路，並在使用主網簽署者前要求額外檢查。

什麼是 Flow Emulator？

Flow Emulator 是輕量級本機網路，可在開發與測試時重現 Flow 區塊鏈的重要行為。

它隨 Flow CLI 一併提供，可使用

啟動。

Flow Emulator 官方文件將其描述為本機環境，可在使用公開網路前執行交易、部署合約及測試應用程式。

由於模擬器在本機執行，開發者可重設狀態、檢視詳細記錄，並測試失敗情境，而不必花費真實加密貨幣。

模擬器包含服務帳戶，可在本機環境中建立帳戶、簽署交易及部署合約。

該服務帳戶的私鑰刻意設為公開且可預測，因此不適用於主網。

模擬器提供近似 Flow Access API 的功能，但開發者不應假設單一電腦能完美重現所有正式環境情況。

公開網路延遲、驗證者行為、網路壅塞、外部服務及正式帳戶設定，都可能造成不同結果。

本機開發流程如何運作？

常見的 Flow CLI 工作流程會先使用

建立專案。

接著，開發者使用

啟動本機區塊鏈。

將 Cadence 合約加入專案，並在

中設定對應項目。

開發者將合約部署至模擬器帳戶，再執行測試交易或指令碼。

可使用

執行自動化測試。

本機測試通過後，可將專案部署至測試網，於共用的公開網路上測試。

只有在程式碼、帳戶設定、簽署者權限、相依項目及部署計畫都經過審查後，才應部署至主網。

Flow CLI 如何部署智能合約？

Flow CLI 可將 Cadence 智能合約部署至專案設定中定義的帳戶。

專案層級的部署指令為

。

官方部署文件說明，此指令會從

讀取合約與部署目標。

開發者可在部署時指定目標網路。

例如，

會將已設定的專案合約部署至本機環境。

將網路切換為 testnet 或 mainnet 後，CLI 會使用對應的帳戶、別名及 Access Node 設定。

部署智能合約屬於區塊鏈交易，因此需要具備適當金鑰權限的帳戶授權。

Cadence 程式碼無效、匯入項目無法解析、帳戶權限不足、簽署金鑰錯誤或網路連線問題，都可能導致部署失敗。

部署至主網可能造成永久影響，因此開發者簽署前應確認合約原始碼與帳戶地址。

Flow CLI 可以更新現有合約嗎？

Flow CLI 可為已儲存在 Flow 帳戶中的合約提交更新交易。

更新必須由合約所屬帳戶中權重足夠的金鑰授權。

Cadence 合約更新必須遵循語言與網路規則，以保護已儲存資源及現有應用程式狀態。

即使交易在技術上有效，更新仍可能引入錯誤、破壞相依應用程式或改變預期行為。

更新正式環境合約前，開發者應執行遷移測試，並確認與既有帳戶資料相容。

Flow 官方合約部署指南說明帳戶設定、部署及合約更新注意事項。

什麼是 Cadence？

Cadence 是為 Flow 區塊鏈設計的智能合約程式語言。

它採用以資源為導向的程式設計概念，表示加密資產及其他不應意外複製或遺失的值。

Flow CLI 包含執行、測試、Lint 檢查、部署及操作 Cadence 程式碼所需的工具。

CLI 與 Cadence 版本必須保持相容，因為語言變更可能影響剖析、型別檢查、執行及合約行為。

截至 Flow CLI 2.17.4 版，隨附的 Cadence 版本為 1.10.3。

開發者可透過Cadence 官方文件了解目前語言行為。

Cadence 指令碼與交易有何不同？

Cadence 指令碼會讀取區塊鏈狀態，但不會永久變更狀態。

指令碼可擷取帳戶餘額、讀取公開合約欄位、計算結果，或檢查已儲存的公開權限。

由於指令碼無法修改區塊鏈狀態，因此不需要交易授權。

Cadence 交易則可以變更區塊鏈狀態。

交易可轉移加密資產、建立資源、呼叫合約函式、修改帳戶儲存內容或執行其他經授權的操作。

交易必須由擔任付款者、提案者或授權者角色的帳戶簽署。

Flow CLI 提供不同的指令群組，用於執行指令碼及傳送交易。

這項區別很重要，因為提交交易涉及授權、費用及狀態變更風險，這些風險與唯讀指令碼並不相同。

Flow CLI 如何傳送交易？

Flow CLI 可建立、簽署、提交及擷取 Flow 交易。

交易指令會指定 Cadence 交易檔案、引數、簽署者設定及目標網路。

CLI 會使用

或命令列選項中的帳戶資訊，產生所需簽章。

交易提交後，會經過多個狀態，最後才取得最終封存結果。

交易提交後，若 Cadence 執行時發生錯誤，仍可能失敗。

開發者應檢查交易結果、發出的事件及錯誤訊息，不應將提交交易視為成功證明。

確切指令語法及可用旗標列於Flow CLI 官方指令總覽。

Flow CLI 如何管理帳戶？

Flow 帳戶可包含加密資產、智能合約、已儲存資源、公開權限及一個或多個公鑰。

Flow CLI 可建立帳戶、擷取帳戶詳細資料、檢查金鑰、新增或撤銷金鑰，並將合約部署至獲授權的帳戶。

帳戶模型將 Flow 地址與任何單一公鑰分開。

一個帳戶可包含多把金鑰，且各自具有不同的權重、簽章演算法、雜湊演算法及序號。

此設計支援金鑰輪替、多部裝置、共同控制及其他授權模式。

Flow 官方帳戶文件說明 Flow 帳戶與「一把金鑰永久決定一個地址」的地址模型有何不同。

只有在其他有效金鑰仍提供足夠授權權重時，撤銷遭入侵的金鑰才能保護帳戶。

開發者在依賴金鑰管理程序保護高價值正式帳戶前，應先進行測試。

Flow CLI 如何處理密碼編譯金鑰？

Flow CLI 包含產生及解碼相容於 Flow 的金鑰指令。

它也提供建立及驗證數位簽章的指令。

產生金鑰時必須使用安全的隨機來源，因為攻擊者可能重建可預測的私鑰。

私鑰絕不可貼到公開問題回報、共用的終端機錄影、聊天訊息或原始碼儲存庫中。

若直接將私鑰當作指令引數輸入，命令列歷史紀錄也可能洩露機密。

正式系統應優先使用權限受限的專用金鑰檔案、硬體保護的儲存裝置，或支援的金鑰管理服務。

金鑰備份必須妥善保護，因為若所有有效金鑰都遺失，可能永久失去控制帳戶的能力。

什麼是 Flow CLI 相依項目管理工具？

Flow CLI 相依項目管理工具會安裝並追蹤專案使用的外部 Cadence 合約。

智能合約經常依賴已部署在 Flow 網路其他位置的標準、介面及實作。

相依項目管理工具可擷取合約原始碼，並更新專案設定，讓匯入項目能正確解析。

指令會顯示專案目前記錄的相依項目。

指令可從支援的網路位置安裝相依項目。

官方相依項目管理文件說明如何安裝、檢查及管理合約相依項目。

開發者應檢查相依項目程式碼及地址，不應假設所有鏈上合約都安全。

惡意或辨識錯誤的相依項目可能在去中心化應用程式中引入未經授權的行為。

團隊也應確認應用程式部署後，其他帳戶是否仍可更新匯入的合約。

Flow CLI 如何測試 Cadence 智能合約？

Flow CLI 包含 Cadence Testing Framework，可透過

指令執行測試檔案。

測試可驗證智能合約、指令碼、交易、發出的事件、帳戶變更及預期的失敗情況。

測試系統在 Cadence 測試環境底層使用 Flow Emulator。

如此一來，測試可建立帳戶、部署合約、提交交易及檢查狀態，而不會影響公開區塊鏈。

Cadence 官方測試指南說明單元測試與整合測試的工作流程。

整合測試尤其重要，因為它能找出帳戶設定、交易授權、匯入項目、權限及資源移動相關問題。

程式碼涵蓋率高不代表合約安全，因為測試可能沒有檢查最危險的假設。

適當情況下，安全關鍵合約還應接受人工審查、對抗式測試及獨立稽核。

Flow CLI 的分叉測試是什麼？

分叉測試會建立本機開發環境，讀取 Flow Mainnet 或 Testnet 的狀態，並在本機執行變更。

開發者可使用真實部署的合約、地址及區塊鏈狀態測試程式碼，而不會修改原本的公開網路。

開發者可使用例如

的指令，啟動以主網狀態為基礎的分叉環境。

Flow 官方分叉測試指南說明本機模擬器如何映照其他 Flow 網路的狀態。

若應用程式依賴難以手動重建的合約或帳戶資料，分叉測試便很有用。

在更新正式合約前，分叉測試也有助於找出相容性問題。

分叉環境不等於建立 Flow 區塊鏈的永久分叉。

它是私人測試副本，其本機交易不會變更主網或測試網。

開發者仍應確認所選區塊高度及網路，因為正式環境狀態日後改變時，測試結果可能不同。

Flow CLI 的 Lint 檢查是什麼？

Lint 檢查會在不部署合約的情況下，檢查原始碼是否有潛在錯誤、不安全模式、格式問題及其他疑慮。

Flow CLI 為 Cadence 專案提供

指令。

Lint 檢查可在開發早期找出部分問題，也可納入自動化檢查流程。

目前版本支援基底目錄選項，供 Cadence 檔案儲存在預設位置以外的專案使用。

Lint 檢查通過並不能證明商業邏輯、存取控制、經濟誘因或資源管理行為正確。

Lint 檢查應與測試、程式碼審查及正式環境監控搭配使用。

如何使用 Flow CLI 查詢區塊鏈資料？

Flow CLI 可擷取 Flow Access API 提供的帳戶、區塊、集合、事件、交易、執行結果及其他資訊。

指令可依識別碼、高度或最新可用區塊擷取區塊資料。

指令可擷取 Flow 帳戶資訊。

事件指令可擷取指定區塊範圍內發出的事件。

交易指令可檢查已提交交易的狀態及結果。

這些功能適用於開發、除錯、監控及簡單的區塊鏈調查。

CLI 並非完整的歷史資料索引工具，因為 Access Nodes 與專用索引服務可能提供不同的查詢能力。

大型分析應用程式通常還需要資料庫、事件處理服務或其他專用基礎設施，不能只依賴 CLI 指令。

什麼是 Flow Interaction Templates？

Flow Interaction Templates 為 Cadence 交易與指令碼提供標準化描述。

這類範本有時稱為 FLIX 範本。

範本可描述錢包或應用程式理解某項操作所需的互動程式碼、引數、相依項目及中繼資料。

Flow CLI 包含 FLIX 指令，可執行、產生及封裝支援的互動項目。

範本有助於應用程式開發者、錢包及智能合約之間維持一致性。

使用者簽署前仍須確認交易程式碼與引數，因為範本無法消除智能合約或錢包風險。

什麼是排程交易指令？

目前版本的 Flow CLI 包含與 Flow 排程交易互動的指令。

排程交易可讓智能合約依網路排程規則安排日後自動執行。

加密貨幣應用情境可能包括定期轉帳、延遲合約操作、自動化金融邏輯及依時間執行的應用程式行為。

指令可建立帳戶管理排程交易所需的管理資源。

其他指令可列出、檢查及取消支援的排程交易。

官方排程交易文件說明設定要求、優先順序及指令行為。

排程交易不保證結果有利，因為執行前資產價格、帳戶餘額、合約狀態及網路狀況都可能改變。

什麼是 Flowser？

Flowser 是可搭配本機 Flow Emulator 環境使用的視覺化瀏覽器。

若具備必要元件，Flow CLI 會提供啟動 Flowser 的指令。

此介面可協助開發者檢查本機帳戶、合約、區塊、交易及事件，不必逐項手動查詢。

Flowser 可補足命令列工具，但不能取代自動化測試或原始碼審查。

本機瀏覽器顯示的結果僅適用於目前的模擬器狀態，不應與主網活動混淆。

什麼是 Flow Dev Wallet？

Flow Dev Wallet 是用於測試錢包授權及應用程式互動的開發工具。

在支援的本機工作流程中，Flow CLI 可啟動開發錢包環境。

開發者可用它模擬登入、帳戶授權、交易核准及其他錢包行為，以便建置去中心化應用程式。

Dev Wallet 並非用於保護有價值的正式資產。

正式環境應用程式必須整合適當的使用者錢包，並遵循安全驗證及交易檢查實務。

Flow CLI 支援 Flow EVM 嗎？

Flow 同時支援 Cadence 智能合約與 Ethereum Virtual Machine 環境，但 Flow CLI 主要是 Flow Cadence 與 Access API 開發模式的官方命令列工作流程。

在 Flow EVM 上執行的 Solidity 應用程式，通常會使用相容 EVM 的 JSON-RPC 工具及 EVM Gateway。

Flow EVM Gateway 官方文件說明，EVM 用戶端會透過實作 Ethereum JSON-RPC 規格的 Gateway 連線。

Cadence 應用程式也可透過 Cadence Owned Accounts 及網路合約與 Flow EVM 互動。

開發者應依應用程式採用 Cadence、Solidity 或結合兩種執行環境來選擇工具。

使用 Flow CLI 這個名稱，不代表所有 EVM 專用操作都透過同一組指令執行。

Flow CLI 與 Flow SDK

Flow CLI 是可互動操作、也可透過指令碼執行的終端機工具。

Flow 軟體開發套件（SDK）則是匯入應用程式程式碼中的程式庫。

CLI 適合本機開發、專案設定、手動網路互動、測試及部署自動化。

SDK 更適合後端服務、應用程式伺服器、機器人、錢包、索引工具及其他執行期間必須與 Flow 通訊的軟體。

開發團隊可使用 Flow CLI 部署合約，再使用 JavaScript、Go 或行動裝置 SDK 從應用程式與合約互動。

這兩類工具彼此互補，而非直接替代關係。

Flow CLI 與圖形化開發環境

圖形化開發環境提供選單、編輯器、視覺化帳戶工具及其他點選功能。

Flow CLI 提供更容易自動化、儲存為指令碼及於持續整合中重現的指令。

圖形化工具可能較容易讓初學者上手，而 CLI 對可重複執行的工作流程則能提供更多控制與透明度。

許多開發者會結合兩種方式，在整合式開發環境中編輯 Cadence，並在內嵌終端機執行 Flow CLI 指令。

官方 Cadence 擴充功能可提供語法支援與開發輔助，Flow CLI 則負責執行及部署。

Flow CLI 可以用於持續整合嗎？

Flow CLI 指令可納入持續整合與持續部署工作流程。

流程可能會安裝固定版本的 CLI、對 Cadence 檔案執行 Lint 檢查、執行測試、初始化模擬器、部署測試合約，並驗證預期交易。

自動化部署至主網所需的控管，必須遠比自動化測試嚴格。

私鑰應儲存在安全的機密管理系統中，而非直接寫在流程檔案裡。

正式環境部署可能需要人工核准、已簽署的發佈成品、受保護的分支及多位審查者。

若測試、Lint 檢查、部署驗證或交易結果檢查未達預期，流程應停止。

團隊也應記錄每次發佈使用的 Flow CLI 與 Cadence 版本。

Flow CLI 會收集使用資料嗎？

目前 Flow CLI 預設會透過 Mixpanel 收集彙總的指令使用次數。

官方文件指出，此使用次數系統不會收集指令引數值與旗標值。

使用者可執行

停用指標收集。

若要重新啟用指標，可執行

。

Flow CLI 官方資料收集說明頁面解釋了收集項目及變更設定的方法。

有隱私、合規或隔離建置需求的組織，應在受控環境安裝 CLI 前檢查遙測行為。

Flow CLI 安全最佳實務

開發者應只透過官方文件或經驗證的版本檔案安裝 Flow CLI。

簽署或部署任何交易前，應確認所選網路。

主網私鑰不應以純文字形式存放在公開專案檔案中。

本機開發、測試、合約管理、金庫控管及一般應用程式操作，應使用不同帳戶與金鑰。

正式帳戶應採用適當的金鑰權重，避免依賴單一未受保護的開發者筆電。

每個網路的合約匯入項目及相依項目地址都應經過確認。

提交交易前，應檢查簽署者角色、引數、Gas 限制及目標合約。

開發者應檢查已封存的交易結果，不應假設已提交的交易必然成功。

將 CLI 版本導入正式工作流程前，應先進行測試。

存在安全的替代授權途徑時，應撤銷舊有或未使用的帳戶金鑰。

絕不可在聲稱必須用來啟用 Flow CLI 的網站中輸入助記詞或私鑰。

常見 Flow CLI 錯誤

連線錯誤可能表示模擬器未執行、Access Node 地址不正確、所選連接埠無法使用，或無法連線至網路服務。

授權錯誤可能源於私鑰、金鑰索引、序號、簽章演算法、雜湊演算法或帳戶地址錯誤。

Cadence 合約別名缺漏或指向錯誤網路地址時，可能發生匯入錯誤。

部署錯誤可能源於 Cadence 程式碼無效、語言版本不相容、相依項目缺漏或帳戶授權不足。

若引數的 Cadence 型別錯誤，或帳戶缺少所需資源或權限，交易可能失敗。

多筆交易幾乎同時嘗試使用同一個提案者金鑰時，可能發生序號錯誤。

開發者應閱讀完整錯誤輸出、確認目前網路，並在變更無關專案設定前使用指令的

選項。

Flow CLI 的常見用途

Flow CLI 可用於建立及設定新的 Cadence 專案。

可執行本機區塊鏈，以進行智能合約開發。

可建立帳戶並管理帳戶金鑰。

可部署及更新 Cadence 合約。

可執行唯讀指令碼及已簽署交易。

可安裝合約相依項目並管理網路別名。

可執行單元測試、整合測試、Lint 檢查及主網狀態分叉測試。

可擷取區塊、交易、帳戶、集合及事件。

可支援自動化建置與部署流程。

在調查應用程式錯誤時，也可協助開發者重現區塊鏈操作。

Flow CLI 的限制

Flow CLI 不會自動確保智能合約安全。

它無法阻止開發者簽署有害交易，或將程式碼部署至錯誤帳戶。

它不能取代專業稽核、威脅模型分析、存取控制設計或營運監控。

本機模擬器無法完美重現所有公開網路狀況。

CLI 也不是為一般消費者設計的完整錢包介面。

它不提供涵蓋所有 Flow 交易的完整歷史分析資料庫。

開發者仍須了解 Cadence、Flow 帳戶、交易角色、權限、資源儲存、相依項目及網路安全。

常見問題

Flow CLI 是什麼意思？

Flow CLI 是 Flow Command-Line Interface（Flow 命令列介面）的縮寫，是 Flow 區塊鏈的官方終端機開發工具。

Flow CLI 是 Dapper Labs 開發的嗎？

Flow 最初由 Dapper Labs 設計與開發；目前 Flow CLI 則由 Onflow 組織以官方開放原始碼 Flow 生態系軟體形式維護。

Flow CLI 是加密貨幣錢包嗎？

不是。Flow CLI 是開發者工具，但可使用設定好的私鑰簽署交易及管理 Flow 帳戶。

Flow CLI 的最新版本是什麼？

截至 2026 年 7 月 14 日，最新官方版本為 Flow CLI 2.17.4。

Flow CLI 2.17.4 隨附哪個 Cadence 版本？

Flow CLI 2.17.4 隨附 Cadence 1.10.3。

如何在 macOS 安裝 Flow CLI？

常見方式是透過 Homebrew 執行

。

如何查看 Flow CLI 版本？

在終端機執行

。

如何建立新的 Flow 專案？

執行

，並選擇適合的專案範本。

什麼是 flow.json？

是主要專案設定檔，用於定義網路、帳戶、合約、相依項目及部署目標。

如何啟動 Flow Emulator？

在終端機執行

。

Flow Emulator 使用真實 FLOW 嗎？

不使用。本機模擬器使用的開發狀態與資產在主網上沒有價值。

Flow CLI 可以將合約部署至主網嗎？

可以。提供正確的網路、帳戶、金鑰及部署設定後，Flow CLI 可將合約部署至 Flow Mainnet。

部署 Flow 專案要使用哪個指令？

標準專案部署指令為

，通常會搭配明確指定的網路選項。

Flow CLI 可以更新智能合約嗎？

可以，但須遵循 Cadence 與 Flow 網路規則，並提交經授權的合約更新交易。

如何執行 Cadence 測試？

在已設定的 Flow 專案中執行

。

什麼是 Flow 分叉測試？

分叉測試會使用複製的主網或測試網狀態執行本機環境，不會變更公開區塊鏈。

Flow CLI 支援建立帳戶嗎？

支援。Flow CLI 可建立及擷取 Flow 帳戶，並管理帳戶金鑰。

Flow CLI 可以讀取區塊鏈資料嗎？

可以。它可透過 Flow Access Nodes 擷取區塊、帳戶、交易、事件、集合及其他資料。

Flow 指令碼與交易有何不同？

指令碼會讀取狀態而不變更區塊鏈；交易則須經簽署，且可修改區塊鏈狀態。

Flow CLI 可以管理合約相依項目嗎？

可以。相依項目管理工具可安裝、列出並追蹤專案使用的外部 Cadence 合約。

Flow CLI 會收集遙測資料嗎？

Flow CLI 目前預設會收集彙總指令次數；使用者可執行

停用此功能。

私鑰應存放在 flow.json 中嗎？

正式環境私鑰不應以未加密的純文字形式存放於共用或公開的

檔案中。

Flow CLI 可用於自動化部署嗎？

可以，但正式環境部署應使用固定版本、妥善保護機密資訊、設置審查控管，並明確確認網路。

Flow CLI 可搭配 Flow Testnet 使用嗎？

可以。透過 Flow CLI 網路設定，測試網是支援的標準環境之一。

Flow CLI 用於 Solidity 開發嗎？

Flow CLI 主要支援 Cadence 及 Flow Access API 工作流程；Flow EVM 上的 Solidity 應用程式通常使用相容 EVM 的 JSON-RPC 工具。

Flow CLI 是開放原始碼嗎？

是。Flow CLI 原始碼依 Apache 2.0 授權公開提供。

使用 Flow CLI 可能造成加密貨幣損失嗎？

可能。錯誤的金鑰、網路、地址、合約程式碼或交易引數，都可能造成無法撤銷的主網資產損失。

結論

Flow CLI 是用於建置 Flow 區塊鏈應用程式及與其互動的官方命令列開發工具。

Flow CLI 與 Dapper Labs 的關係，源於 Dapper Labs 最初設計與開發 Flow；目前 CLI 則以開放原始碼 Flow 生態系軟體形式運作。

此工具整合專案初始化、模擬器存取、Cadence 測試、帳戶管理、金鑰操作、合約部署、相依項目管理、交易提交及區塊鏈查詢。

其

設定系統可協助開發者在模擬器、測試網、主網及本機網路分叉環境中管理一致的設定。

Flow CLI 可讓區塊鏈開發流程更容易重複執行，但無法消除金鑰不安全、合約有缺陷、部署目標錯誤、惡意相依項目或交易無法撤銷等風險。

開發者應使用官方版本、保護簽署憑證、在多種環境中測試、檢查交易結果，並在部署至 Flow Mainnet 前採取嚴格審查控管。