哈囉，世界！
在本章中，您將學習如何建立一個新的 Move 套件、編寫一個簡單的模組、編譯它，並使用 Move CLI 執行測試。請確保您已安裝 Sui 並設定好您的 IDE 環境。執行以下指令來測試 Sui 是否已正確安裝。
# 它應該會印出客戶端版本。例如：sui-client 1.22.0-036299745。
sui client --version
Move CLI 是 Move 語言的命令列介面；它內建於 Sui 二進位檔中，並提供一組指令來管理套件、編譯和測試程式碼。
本章的結構如下：
建立新套件
為了建立一個新程式，我們將使用 sui move new 指令，後面接著應用程式的名稱。我們的第一個程式將命名為 hello_world。
注意：在本章及其他章節中，如果您看到程式碼區塊中的行以 $ (錢字號) 開頭，表示後續的指令應在終端機中執行。錢字號不應被包含在內。這是終端機環境中顯示指令的常見方式。
$ sui move new hello_world
sui move 指令提供 Move CLI 的存取權限——這是一個內建的編譯器、測試執行器和 Move 相關的實用工具。 new 指令後面接著套件名稱，將在一個新資料夾中建立一個新套件。在我們的例子中，資料夾名稱是 "hello_world"。
我們可以查看該資料夾的內容，以確認套件已成功建立。
$ ls -l hello_world
Move.toml
sources
tests
目錄結構
Move CLI 將建立應用程式的鷹架，並預先建立目錄結構和所有必要檔案。讓我們看看裡面有什麼。
hello_world
├── Move.toml
├── sources
│ └── hello_world.move
└── tests
└── hello_world_tests.move
清單文件 (Manifest)
Move.toml 檔案，又稱為套件清單文件，包含套件的定義和配置設定。Move 編譯器使用它來管理套件中繼資料、獲取依賴項並註冊具名位址。我們將在概念章節中詳細解釋它。
預設情況下，該套件有一個具名位址——套件的名稱。
[addresses]
hello_world = "0x0"
原始碼
sources/ 目錄包含原始碼檔案。Move 原始碼檔案具有 .move 副檔名，通常以檔案中定義的模組命名。例如，在我們的案例中，檔案名稱是 hello_world.move，並且 Move CLI 已經在裡面放置了註解掉的程式碼：
/*
/// 模組：hello_world
module hello_world::hello_world;
*/
/* 和 */ 是 Move 中的註解分隔符號。它們之間的所有內容都會被編譯器忽略，可用於文件或備註。我們在基本語法中解釋了所有註解程式碼的方法。
註解掉的程式碼是一個模組定義，它以關鍵字 module 開頭，後面跟著一個具名位址（或位址文字），以及模組名稱。模組名稱是模組的唯一識別符號，並且在套件內必須是唯一的。模組名稱用於從其他模組或交易中引用該模組。
測試
tests/ 目錄包含套件測試。編譯器在常規建置過程中會排除這些檔案，但在 test 和 dev 模式下會使用它們。測試是用 Move 編寫的，並標記有 #[test] 屬性。測試可以分組在單獨的模組中（通常稱為 module_name_tests.move），或在它們所測試的模組內部。
模組、匯入、常數和函數可以用 #[test_only] 進行註解。此屬性用於將模組、函數或匯入從建置過程中排除。當您想為測試添加輔助工具而不將它們包含在將發佈到鏈上的程式碼中時，這會很有用。
hello_world_tests.move 檔案包含一個註解掉的測試模組模板：
/*
#[test_only]
module hello_world::hello_world_tests;
// 取消註解此行以匯入模組
// use hello_world::hello_world;
const ENotImplemented: u64 = 0;
#[test]
fun test_hello_world() {
// 成功
}
#[test, expected_failure(abort_code = hello_world::hello_world_tests::ENotImplemented)]
fun test_hello_world_fail() {
abort ENotImplemented
}
*/
其他資料夾
此外，Move CLI 支援 examples/ 資料夾。其中的檔案處理方式與放在 tests/ 資料夾下的檔案類似——它們只在 test 和 dev 模式下建置。它們是用來展示如何使用套件或如何將其與其他套件整合的範例。最常見的用途是出於文件目的和函式庫套件。
編譯套件
Move 是一種編譯型語言，因此它需要將原始碼檔案編譯成 Move 位元組碼。它僅包含有關模組、其成員和類型所需的資訊，並排除註解和一些識別符（例如，常數的識別符）。
為了展示這些功能，讓我們將 sources/hello_world.move 檔案的內容替換為以下內容：
/// 模組 `hello_world` 位於具名地址 `hello_world` 下。
/// 具名地址在 `Move.toml` 中設定。
module hello_world::hello_world;
// 從標準程式庫匯入 `String` 類型
use std::string::String;
/// 回傳 "Hello World!" 作為 `String`。
public fun hello_world(): String {
b"Hello, World!".to_string()
}
在編譯期間，程式碼被建置，但不會執行。編譯後的套件只包含可以由其他模組或在交易中呼叫的函數。我們將在概念章節中解釋這些概念。但現在，讓我們看看當我們執行 sui move build 時會發生什麼。
# 從 `hello_world` 資料夾執行
$ sui move build
# 或者，如果您沒有 `cd` 進入該資料夾
$ sui move build --path hello_world
它應該在您的控制台輸出以下訊息。
UPDATING GIT DEPENDENCY https://github.com/MystenLabs/sui.git
INCLUDING DEPENDENCY Bridge
INCLUDING DEPENDENCY DeepBook
INCLUDING DEPENDENCY SuiSystem
INCLUDING DEPENDENCY Sui
INCLUDING DEPENDENCY MoveStdlib
BUILDING hello_world
在編譯期間，Move 編譯器會自動建立一個建置資料夾，其中放置所有已獲取和編譯的依賴項，以及當前套件模組的位元組碼。
如果您使用版本控制系統（例如 Git），則應忽略建置資料夾。例如，您應該使用 .gitignore 檔案並將 build 添加到其中。
執行測試
在我們進行測試之前，我們應該添加一個測試。Move 編譯器支援用 Move 編寫的測試並提供執行環境。測試可以放在原始碼檔案和 tests/ 資料夾中。測試標記有 #[test] 屬性，並會被編譯器自動發現。我們在測試部分深入解釋測試。
將 tests/hello_world_tests.move 的內容替換為以下內容：
#[test_only]
module hello_world::hello_world_tests;
use std::unit_test::assert_eq;
use hello_world::hello_world;
#[test]
fun test_hello_world() {
assert_eq!(hello_world::hello_world(), b"Hello, World!".to_string());
}
這裡我們匯入了 hello_world 模組，並呼叫其 hello_world 函數來測試輸出確實是字串 "Hello, World!"。現在，既然我們已經準備好測試，就讓我們以測試模式編譯套件並執行測試。Move CLI 為此提供了 test 指令：
$ sui move test
輸出應該與以下內容相似：
INCLUDING DEPENDENCY Bridge
INCLUDING DEPENDENCY DeepBook
INCLUDING DEPENDENCY SuiSystem
INCLUDING DEPENDENCY Sui
INCLUDING DEPENDENCY MoveStdlib
BUILDING hello_world
Running Move unit tests
[ PASS ] 0x0::hello_world_tests::test_hello_world
Test result: OK. Total tests: 1; passed: 1; failed: 0
如果您在套件資料夾外執行測試，您可以指定套件的路徑：
$ sui move test --path hello_world
您也可以透過指定字串來一次執行一個或多個測試。所有包含該字串的測試名稱都將被執行：
$ sui move test test_hello
後續步驟
在本節中，我們解釋了 Move 套件的基礎知識：其結構、清單文件、建置和測試流程。在下一頁，我們將編寫一個應用程式，並了解程式碼的結構以及該語言能做什麼。