Cardano CLI 详解：区块链开发者指南_新闻

免责声明：内容不构成买卖依据，投资有风险，入市需谨慎！

Cardano CLI 详解：区块链开发者指南

2026-10-20 16:04:00

Cardano CLI 详解：区块链开发者的必备工具

每一位 Cardano 开发者最终都会与命令行界面（CLI）相遇。Cardano CLI 通过连接正在运行的节点，能够创建密钥、读取链上数据以及发送交易。它也是了解钱包后台运作机制的最直观方式之一。

本指南将解释 Cardano CLI 的功能、第一笔交易的执行流程，以及在操作真实资金前需要检查的关键事项。

什么是 Cardano CLI？

Cardano CLI 是一个命令行工具，它连接到 Cardano 节点以生成密钥、构建地址、查询账本，并构建、签名和提交交易。

Cardano CLI 的实际工作原理

Cardano CLI 本身不持有资金。它通过套接字向本地节点发送指令，并读取回复。这种设计使其非常适合学习、脚本编写和测试，尽管大多数面向消费者的应用程序完全隐藏了这一层。

为了理解节点在整个架构中的位置，建议参考关于 Cardano 分层结构和网络架构的相关指南。

开始前的准备工作

运行中的节点：Cardano-CLI 需要一个节点来响应查询。
套接字路径：设置环境变量 CARDANO_NODE_SOCKET_PATH，以便命令能找到节点。
网络选择：务必从测试网开始，切勿直接在主网进行测试。
测试资金：官方水龙头提供测试 ADA。
整洁的文件夹：将密钥和交易文件保存在一个有序的位置。

核心命令组

命令组用途示例用法address创建密钥和地址key-gen, buildquery读取链上数据tip, utxo, protocol-parameterstransaction构建、签名和提交交易build, sign, submit 其他组别涵盖质押和治理功能。由于版本差异，请运行内置帮助命令以查看您的安装支持哪些功能。在命令前可能会出现时代名称，如 conway 或 latest。

你将遇到的文件

初学者往往会对文件名感到困惑。以下是官方教程中使用的关键文件：

payment.vkey：验证密钥，可以安全地共享。
payment.skey：签名密钥，控制资金，必须严格保密。
payment.addr：由验证密钥构建的地址文件。
tx.signed：已签名的交易文件，准备提交。

理解每个文件的用途将使阅读每一个 Cardano-CLI 命令变得更加轻松。

你的第一笔交易：构建、签名、提交

根据开发者门户的说法，每一次 Cardano 交互都遵循相同的三个步骤。测试网的启动流程如下：

告知工具节点的位置：将环境变量 CARDANO_NODE_SOCKET_PATH 设置为节点的套接字文件路径，这样 Cardano CLI 就知道要与哪个节点通信。
创建密钥对：要求 Cardano CLI 生成验证密钥（payment.vkey，可安全共享）和签名密钥（payment.skey，必须保密）。
构建你的地址：使用验证密钥创建支付地址，并将其保存到名为 payment.addr 的文件中。
检查资金：查询该地址持有的未花费输出（UTXO）。这将显示你可以花费的资金。
执行交易：从水龙头资助地址后，为你的时代运行构建、签名和提交命令，每次都要添加网络标志。Cardano CLI 会在发出交易之前将其保存到文件中，这给了你检查的机会。请遵循官方页面获取确切选项。

Build vs. Build-Raw

特性buildbuild-raw费用计算自动计算由用户输入变更输出处理使用变更地址处理手动计算最佳适用对象大多数初学者完全手动控制 Cardano 社区论坛的回答通常建议初学者使用变更地址进行构建，因为手动计算费用很容易出错。

选择合适的网络

Mainnet（主网）：真实的 ADA，使用 mainnet 标志选择。
Preprod：稳定的测试网，使用魔术数字 1。
Preview：变化更快的测试网，使用魔术数字 2。

在每次命令前请检查此值。如果 Cardano CLI 指向错误的网络，它不会发出警告，且发送到那里的交易只会失败。

快速场景模拟

想象一位开发人员正在测试支付流程。她在 preprod 上生成密钥，从水龙头资助地址并查询 UTXO 列表。她构建了一笔小额转账，签名并提交。然后她再次查询地址以确认新余额。这一切都不涉及真实资金，因此每个错误都是零成本的学习机会。

何时使用 CLI 而非 SDK？

Cardano CLI 非常适合学习、脚本编写和调试。应用程序开发人员通常会集成 SDK，官方教程展示了多种 SDK 的使用示例。一个实用的分工策略是：使用 Cardano-CLI 来理解每一步骤，然后将重复性工作转化为代码。

常见错误及解决方法

输入未找到：UTXO 可能已被花费，请重新运行查询。
网络错误：资金可能位于 preprod，而命令针对的是 preview。
套接字错误：节点可能已停止，或者套接字变量未设置。
费用或 TTL 问题：手动构建需要正确的值，这也是为什么 build 命令更友好的原因。

安全与风险检查

签名密钥：payment.skey 控制资金，切勿分享或将其提交到代码仓库。
主网谨慎：先在 preprod 或 preview 上进行测试，并仔细检查每个标志。
虚假工具：仅从官方来源下载软件。相关指南列出了常见的诈骗手段。
复制的命令：来自论坛的代码片段可能已过时，请与官方文档进行比较。
市场噪音：价格预测与 Cardano CLI 的工作原理无关。

结语

Cardano CLI 将区块链工作简化为基本动作：生成密钥、读取账本、构建交易、签名并发送。掌握这些动作将使理解每一个钱包和 SDK 变得更容易。

开发者应始终在测试网上开始操作，每次确认网络标志，并小心保护签名密钥。耐心地使用 Cardano CLI，它将成为任何在 Cardano 上构建项目的可靠伙伴。

免责声明：

本网站、超链接、相关应用程序、论坛、博客等媒体账户以及其他平台和用户发布的所有内容均来源于第三方平台及平台用户。百亿财经对于网站及其内容不作任何类型的保证，网站所有区块链相关数据以及其他内容资料仅供用户学习及研究之用，不构成任何投资、法律等其他领域的建议和依据。百亿财经用户以及其他第三方平台在本网站发布的任何内容均由其个人负责，与百亿财经无关。百亿财经不对任何因使用本网站信息而导致的任何损失负责。您需谨慎使用相关数据及内容，并自行承担所带来的一切风险。强烈建议您独自对内容进行研究、审查、分析和验证。

展开阅读全文