Anchor CLI 基础知识

本节提供了一些常用命令和示例,帮助您开始使用 Anchor CLI。

初始化项目

运行下面所示的命令来创建一个新的 Anchor 项目。该命令会创建一个以项目名称命名的新目录,并使用该目录初始化一个新的 Anchor 项目。

Terminal
$
anchor init <project-name>

例如,下面的命令将创建一个名为 my-project 的项目。my-project 目录将包含一个模块化的 Rust 程序,以及一个使用 LiteSVM 的 Rust 测试模板。

Terminal
$
anchor init my-project

如果想改为生成 TypeScript 测试模板,请明确指定模板。例如,使用 Mocha 模板:

Terminal
$
anchor init my-project --test-template mocha

TypeScript 测试模板需要 Node.js 和 JavaScript 包管理器。

然后进入项目目录:

Terminal
$
cd <project-name>

请参阅 Anchor 的项目文件结构。

构建程序

要构建您的项目,请运行以下命令:

Terminal
$
anchor build

编译后的程序可以在 /target/deploy 目录中找到。

平台工具安装失败

如果构建时提示平台工具(platform-tools)目录无效,请重新安装 SBF 构建工具,然后重试构建:

Terminal
$
cargo build-sbf --force-tools-install
$
anchor build

部署程序

要部署您的项目,请运行以下命令:

Terminal
$
anchor deploy

此命令会将您的程序部署到 Anchor.toml 文件中指定的 cluster。

测试程序

要测试您的项目,请运行以下命令:

Terminal
$
anchor test

此命令会构建、部署并运行您的项目测试。

当使用 localnet 集群时,Anchor 会自动启动本地 validator,部署程序,运行测试,然后停止 validator。

JavaScript 测试运行器错误

如果您选择了 JavaScript 或 TypeScript 测试模板,以下任一错误都可能表示未安装 Node.js 或所配置的包管理器:

Permission denied (os error 13)
No such file or directory (os error 2)

Is this page helpful?

Table of Contents

Edit Page
©️ 2026 Solana 基金会版权所有