Skip to main content
欢迎来到 Aptos Move 开发的世界！本指南将带你完成从环境搭建到在 Aptos 测试网（Testnet）上发布第一个智能合约的全过程。
我们将这个过程比作烹饪：你需要先搭建好厨房（环境），准备好食材（账户与代币），然后才能开始烹饪（写代码）并最终上菜（发布）。

​
准备工作

在开始之前，请确保你熟悉命令行的基本操作。
1

搭建厨房：安装 Aptos CLI

Aptos CLI 是我们与区块链交互的主要工具。
brew install aptos
安装完成后，验证安装是否成功：
aptos --version
2

配置 IDE：VS Code + Aptos 插件

推荐使用 Visual Studio Code 进行开发。为了获得语法高亮和代码提示，请安装官方插件。
  1. 打开 VS Code。
  2. 搜索 “Aptos”。
  3. 安装由 Aptos Labs 发布的官方插件 (名称通常为 Aptos 或 Move on Aptos)。
3

准备食材：初始化账户与领取水龙头

我们需要一个 Aptos 账户来支付交易费用（Gas）。运行以下命令初始化配置：
aptos init
  • Choose network: 输入 testnet
  • Private key: 直接回车（自动生成新私钥）
4

烹饪第一道菜：编写 Hello World

创建一个新的 Move 项目：
mkdir hello_aptos
cd hello_aptos
aptos move init --name hello_aptos
在 sources 目录下创建文件 hello_blockchain.move，并写入以下代码：
sources/hello_blockchain.move
module hello_aptos::message {
    use std::string::{String, utf8};
    use std::signer;

    struct MessageHolder has key {
        message: String,
    }

    // acquires MessageHolder: 函数体内使用了 borrow_global_mut<MessageHolder>，必须显式声明
    entry fun set_message(account: &signer, message_bytes: vector<u8>) acquires MessageHolder {
        let message = utf8(message_bytes);
        let account_addr = signer::address_of(account);
        if (!exists<MessageHolder>(account_addr)) {
            // move_to: 将资源发布到 account 的地址下
            move_to(account, MessageHolder { message });
        } else {
            // borrow_global_mut: 获取资源的引用以修改它
            let old_message_holder = borrow_global_mut<MessageHolder>(account_addr);
            old_message_holder.message = message;
        }
    }
}
这段代码定义了一个可以存储字符串消息的资源 MessageHolder，以及一个可以修改该消息的入口函数 set_message。
5

上菜：编译与发布

将你的合约发布到 Aptos 测试网：
aptos move publish --named-addresses hello_aptos=default
  • 当询问是否发布时，输入 yes。
成功后，你将看到一个 Transaction Hash。
6

品尝：在浏览器中验证

复制上一步生成的 Transaction Hash，访问 Aptos Explorer。粘贴哈希值，你将看到你的合约代码已经公开在区块链上，并且可以通过 Explorer 的 UI 界面直接调用 set_message 函数进行交互！

​
下一步

恭喜！你已经完成了第一次 Aptos Move 开发之旅。接下来，你可以：

学习基础语法

深入了解 Move 的数据类型与控制流。

理解资源模型

掌握 Move 语言的核心：Resource。