name: use-algokit-cli description: 用于构建、测试和部署Algorand应用程序的AlgoKit CLI命令。适用于构建或编译智能合约、运行测试套件、部署到本地网络、管理本地Algorand网络或理解开发工作流程。强触发词包括“构建合约”、“运行测试”、“启动本地网络”、“部署到本地网络”、“algokit project run”、“localnet status”。
AlgoKit 命令
使用AlgoKit CLI进行Algorand开发的标准命令。
概述 / 核心工作流程
- 编写合约代码
- 构建：
algokit project run build - 使用生成的客户端编写测试
- 测试：
algokit project run test - 部署：
algokit project deploy localnet
操作步骤
-
构建合约：
algokit project run build通过Puya编译合约，生成ARC56规范，并创建类型化客户端。
-
运行测试：
algokit project run test使用Vitest执行测试套件。
-
启动本地网络（如果需要）：
algokit localnet start -
部署到本地网络：
algokit project deploy localnet -
检查构建产物：
artifacts/— 已编译的合约、ARC56规范- TypeScript/Python的生成客户端文件
重要规则 / 指南
- 测试前始终先构建 — 测试使用生成的客户端
- 仅在明确请求时部署 — 不要自动部署
- 部署操作前检查本地网络状态
- 如果需要干净状态，重置本地网络
常见变体 / 边缘情况
| 场景 | 命令 |
|---|---|
| 启动本地网络 | algokit localnet start |
| 停止本地网络 | algokit localnet stop |
| 重置网络状态 | algokit localnet reset |
| 检查网络状态 | algokit localnet status |
| 构建失败 | 检查Puya编译器错误，修复合约代码 |
| 测试失败 | 检查测试断言，修复合约或测试代码 |