Skip to main content

🛳️ 设置 Anchor - 从原始人到现代人的进化！

🎯 欢迎来到Anchor的世界！​

嘿，Solana勇士们！👋 恭喜你一路披荆斩棘，像个原始人一样徒手撸代码到现在！💪 现在，是时候进化了 —— 让我们拥抱现代文明，使用Anchor框架！

想象一下：

  • 🔨 原生开发 = 用石头敲钉子
  • ⚡ Anchor开发 = 用电动工具

🎯 今日任务： 安装配置Anchor，让你的开发效率提升10倍！

🤔 为什么选择Anchor？​

┌─────────────────────────────────────────┐
│         原生 vs Anchor 对比              │
├─────────────────────────────────────────┤
│  原生开发 😰                Anchor 😎    │
│  ───────────              ──────────    │
│  100行样板代码      →      10行搞定      │
│  手动验证账户       →      自动验证      │
│  手写序列化         →      自动处理      │
│  容易出安全漏洞     →      内置安全检查   │
│  调试困难          →      清晰的错误信息  │
└─────────────────────────────────────────┘

Anchor就像是React之于原生JavaScript！ 🚀

🛠️ 安装前的准备工作​

📋 检查清单​

在开始之前，确保你已经安装了这些工具：

# ✅ 检查 Rust 是否安装
rustc --version
# 输出示例: rustc 1.73.0

# ✅ 检查 Solana CLI
solana --version
# 输出示例: solana-cli 1.17.0

# ✅ 检查 Node.js
node --version
# 输出示例: v18.0.0

# ✅ 安装 Yarn（如果还没有）
npm install -g yarn
yarn --version
# 输出示例: 1.22.0

💡 Pro Tip: 如果缺少任何工具，先暂停并安装它们！这就像做饭前要准备好所有食材一样重要！

🚀 Step 1: 安装Anchor​

📦 安装Anchor CLI​

根据你的操作系统选择安装方式：

# 🐧 Linux/WSL/Mac 用户（推荐方式）
cargo install --git https://github.com/coral-xyz/anchor anchor-cli --locked

# 🍎 Mac用户也可以用Homebrew
brew install anchor

# 🪟 Windows用户
# 强烈建议使用WSL2！原生Windows可能会遇到各种问题

✅ 验证安装​

# 🎯 检查Anchor版本
anchor --version

# ✨ 成功输出示例：
# anchor-cli 0.29.0

🎉 恭喜！ 如果你看到版本号，说明Anchor已经成功安装！

🏗️ Step 2: 创建你的第一个Anchor项目​

🎨 初始化项目​

# 🚀 创建一个新的Anchor项目
# 命名建议：使用小写字母和下划线
anchor init my_awesome_dapp

# 📁 进入项目目录
cd my_awesome_dapp

📂 项目结构解析​

让我们看看Anchor为我们创建了什么：

📦 my_awesome_dapp/
├── 📄 Anchor.toml          # ⚙️ Anchor配置中心
├── 📄 Cargo.toml           # 📦 Rust包管理
├── 📄 package.json         # 📦 JavaScript依赖
├── 📁 programs/            # 🎯 智能合约代码
│   └── 📁 my_awesome_dapp/
│       ├── 📄 Cargo.toml
│       └── 📁 src/
│           └── 📄 lib.rs   # 💎 主程序文件！
├── 📁 tests/              # 🧪 测试文件
│   └── 📄 my_awesome_dapp.ts
├── 📁 app/                # 🎨 前端应用（可选）
├── 📁 migrations/         # 📊 部署脚本
└── 📁 .anchor/           # 🔧 Anchor内部文件
    ├── 📁 program-logs/  # 📝 程序日志
    └── 📁 test-ledger/   # 💾 本地测试账本

🔍 深入了解关键文件​

1️⃣ Anchor.toml - 项目配置文件​

# 🎯 Anchor.toml - 项目的控制中心
[features]
seeds = false  # 是否使用PDA种子生成
skip-lint = false  # 是否跳过代码检查

[programs.localnet]
my_awesome_dapp = "你的程序ID"  # 本地网络程序ID

[programs.devnet]
my_awesome_dapp = "你的程序ID"  # 开发网程序ID

[registry]
url = "https://api.apr.dev"  # Anchor程序注册表

[provider]
cluster = "localnet"  # 🌐 默认网络（可改为devnet/mainnet）
wallet = "~/.config/solana/id.json"  # 💳 钱包路径

[scripts]
test = "yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts"

2️⃣ lib.rs - 主程序文件​

// 📄 programs/my_awesome_dapp/src/lib.rs
use anchor_lang::prelude::*;

// 🆔 声明程序ID - 这是你程序的唯一标识符！
// Anchor会为你自动生成一个
declare_id!("11111111111111111111111111111111");

// 🎮 主程序模块
#[program]
pub mod my_awesome_dapp {
    use super::*;

    // 🚀 初始化函数 - 你的第一个指令！
    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        msg!("🎉 程序初始化成功！");
        Ok(())
    }
}

// 📦 定义账户结构
#[derive(Accounts)]
pub struct Initialize {}

💡 魔法解释：

  • #[program] = 告诉Anchor这是主程序模块
  • declare_id! = 声明程序的唯一ID
  • Context = 包含所有账户信息的上下文
  • Result<()> = Rust的错误处理机制

🔧 Step 3: 获取程序ID​

🔑 查看你的程序ID​

# 🎯 列出所有程序密钥
anchor keys list

# 输出示例：
# my_awesome_dapp: 7KqAdFnLkX5REPYY3ihUcPJUbDxLVDzWdMoWBcUHDqkE

📝 同步程序ID​

# 🔄 将程序ID同步到所有需要的地方
anchor keys sync

# 这会自动更新：
# ✅ lib.rs 中的 declare_id!
# ✅ Anchor.toml 中的程序ID
# ✅ 测试文件中的程序ID

🎯 重要提示： 程序ID就像你的身份证号码，必须保持一致！

🌐 Step 4: 配置部署网络​

🎯 选择你的战场​

打开 Anchor.toml，修改 cluster 设置：

[provider]
# 🏠 本地网络（用于测试）
cluster = "localnet"

# 🧪 开发网（用于开发）
# cluster = "devnet"

# 💎 主网（用于生产）
# cluster = "mainnet-beta"

💰 确保有足够的SOL​

# 🪙 检查余额
solana balance

# 💸 如果在devnet，可以空投SOL
solana airdrop 2

# 🎯 设置网络
solana config set --url devnet

🏗️ Step 5: 构建程序​

🔨 编译你的程序​

# 🏗️ 构建程序
anchor build

# 🎯 这会做以下事情：
# 1. 编译Rust代码为BPF字节码
# 2. 生成IDL文件（接口描述）
# 3. 生成TypeScript类型定义

📁 构建产物​

构建完成后，检查生成的文件：

📦 target/
├── 📁 deploy/
│   └── 📄 my_awesome_dapp.so  # 🎯 编译后的程序
├── 📁 idl/
│   └── 📄 my_awesome_dapp.json # 📋 IDL文件
└── 📁 types/
    └── 📄 my_awesome_dapp.ts   # 📝 TypeScript类型

💡 IDL是什么？ IDL (Interface Description Language) 就像程序的说明书，告诉客户端：

  • 有哪些函数可以调用
  • 需要什么参数
  • 返回什么数据

🚀 Step 6: 部署程序​

🎯 部署到目标网络​

# 🚀 部署程序
anchor deploy

# 成功输出示例：
# Deploying workspace: https://api.devnet.solana.com
# Upgrade authority: 7fUAJ...
# Deploying program "my_awesome_dapp"...
# Program path: target/deploy/my_awesome_dapp.so
# Program ID: 7KqAdFnLkX5REPYY3ihUcPJUbDxLVDzWdMoWBcUHDqkE
#
# ✅ Deploy success

🔍 验证部署​

# 📋 查看程序信息
solana program show <你的程序ID>

# 📊 查看程序账户
solana account <你的程序ID>

🧪 Step 7: 运行测试​

🎯 测试你的程序​

# 🧪 运行测试（会自动启动本地验证器）
anchor test

# 🎯 跳过构建直接测试
anchor test --skip-build

# 🌐 在特定网络测试
anchor test --provider.cluster devnet

📝 测试文件示例​

// 📄 tests/my_awesome_dapp.ts
import * as anchor from "@coral-xyz/anchor";
import { Program } from "@coral-xyz/anchor";
import { MyAwesomeDapp } from "../target/types/my_awesome_dapp";

describe("my_awesome_dapp", () => {
  // 🔧 配置provider
  const provider = anchor.AnchorProvider.env();
  anchor.setProvider(provider);

  // 📦 获取程序实例
  const program = anchor.workspace.MyAwesomeDapp as Program<MyAwesomeDapp>;

  it("初始化成功!", async () => {
    // 🚀 调用初始化函数
    const tx = await program.methods.initialize().rpc();

    console.log("🎉 交易签名:", tx);
  });
});

💡 实用技巧与最佳实践​

🎯 技巧1：使用别名加速开发​

# 📝 在 ~/.bashrc 或 ~/.zshrc 中添加
alias ab='anchor build'
alias ad='anchor deploy'
alias at='anchor test'
alias akl='anchor keys list'

🎯 技巧2：调试日志​

// 🔍 在程序中添加调试信息
msg!("🐛 Debug: 账户余额 = {}", account.balance);
msg!("📊 当前状态: {:?}", state);

🎯 技巧3：本地开发流程​

# 🔄 完整的开发循环
# 1. 修改代码
# 2. 构建
anchor build
# 3. 测试
anchor test --skip-local-validator
# 4. 部署
anchor deploy

🚨 常见问题解决​

❌ 问题1：构建失败​

# 🔧 清理并重新构建
anchor clean
cargo clean
anchor build

❌ 问题2：程序ID不匹配​

# 🔄 重新同步程序ID
anchor keys sync
# 然后重新构建
anchor build

❌ 问题3：余额不足​

# 💰 获取更多SOL
solana airdrop 5
# 或者切换到本地网络测试
solana config set --url localhost

🎓 知识总结​

📚 Anchor命令速查表​

# 🏗️ 项目管理
anchor init <name>      # 创建新项目
anchor build           # 构建程序
anchor deploy          # 部署程序
anchor test           # 运行测试
anchor clean          # 清理构建文件

# 🔑 密钥管理
anchor keys list      # 列出程序ID
anchor keys sync      # 同步程序ID

# 📊 其他有用命令
anchor idl init       # 初始化IDL
anchor idl upgrade    # 更新IDL
anchor verify        # 验证部署的程序

🚀 下一步​

恭喜你！🎉 你已经成功搭建了Anchor开发环境！现在你拥有了：

  • ✅ 完整的Anchor工具链
  • ✅ 第一个Anchor项目
  • ✅ 部署和测试流程

🎯 接下来你可以：​

  1. 深入学习Anchor特性 - 账户验证、错误处理、PDA等
  2. 构建真实项目 - 从简单的计数器到复杂的DeFi应用
  3. 优化和安全 - 学习最佳实践和安全模式

💬 记住： Anchor让Solana开发变得简单，但理解底层原理仍然很重要！

准备好用Anchor构建下一个百万美元的DApp了吗？让我们开始吧！ 🚀⚓✨