比特币（BTC）作为首个去中心化的数字货币，其核心功能离不开强大的客户端软件，Bitcoin Core（原 Bitcoin-Qt）是最官方、最功能完备的比特币节点客户端，它不仅管理用户的钱包，还参与整个比特币网络的共识与数据同步，对于希望深入了解比特币或需要更精细控制钱包功能的用户而言，掌握 Bitcoin Core 的命令行接口（CLI）命令至关重要，本文将详细介绍 BTC 客户端命令的基本概念、常用命令及其应用场景。

什么是 Bitcoin Core 命令行接口？

Bitcoin Core 提供了一个图形化用户界面（GUI），方便普通用户进行查看余额、发送接收比特币等操作，但其背后，更强大、更灵活的功能则通过命令行接口（CLI）实现，CLI 允许用户通过输入特定的文本命令来与 Bitcoin Core 节点进行交互，执行诸如查询信息、交易管理、网络控制等多种操作，这些命令通常通过 bitcoin-cli 可执行文件调用，该文件随 Bitcoin Core 安装包一同提供。

准备工作：运行 bitcoin-cli

在使用 bitcoin-cli 命令之前，确保你的 Bitcoin Core 节点已经完全同步（至少同步到最新的区块高度），并且钱包已解锁（如果需要密码）,基本命令格式如下：

bitcoin-cli [命令] [参数1] [参数2] ...

查看帮助信息：

bitcoin-cli help

或者查看特定命令的帮助：

bitcoin-cli help sendtoaddress

常用 BTC 客户端命令详解

以下是一些最常用且实用的 Bitcoin Core 命令，涵盖了钱包管理、交易查询、网络信息等方面：

  1. 钱包与地址管理：

    • getnewaddress [标签]：生成一个新的比特币接收地址，可选的“标签”用于给地址分类。
      bitcoin-cli getnewaddress "接收地址1"
    • getaddressesbylabel "标签"：获取指定标签下所有关联的地址。
    • listaddresses：列出钱包中的所有地址。
    • getbalance ["账户"] [最小确认数]：查看钱包余额，可以指定账户和最小确认数（未确认的余额默认不计入）。
      bitcoin-cli getbalance
    • listtransactions [账户] [计数] [从] [包括 watchonly]：列出钱包中的交易记录，可以指定账户、返回数量、起始偏移量等。
      bitcoin-cli listtransactions 10 0

  2. 交易操作：

    • sendtoaddress "地址" "金额" [注释] [注释_to] [替换费用] [可替代] [锁定时间]：发送比特币到指定地址。
      • "地址"：接收方比特币地址。
      • "金额"：发送的比特币数量（以 BTC 为单位）。
      • [注释]：可选的交易注释。
      • [替换费用]：是否允许替换交易（用于 RBF）。
        bitcoin-cli sendtoaddress "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" 0.1 "测试转账"
    • createrawtransaction [{"txid":"id","vout":n},...] {"address":amount,...} [locktime]：创建一个原始交易（未签名的交易），这允许用户构建复杂的交易,例如多输入多输出。
    • signrawtransactionwithwallet "hexstring" [{"txid":"id","vout":n,"scriptPubKey":"hex",redeemScript:"hex"},...] [私钥] [sighashtype]：使用钱包中的私钥对原始交易进行签名。
    • sendrawtransaction "hexstring" [允许高费用]：将已签名的原始交易广播到比特币网络。
    • gettransaction "txid" [包含_watchonly]：获取特定交易的详细信息，如金额、确认数、区块哈希等。

  3. 区块链与网络信息：

    • getblockcount：获取当前区块链的区块高度。
    • getblockhash "高度"：获取指定高度的区块哈希值。
    • getblock "区块哈希" [详细]：获取指定区块的详细信息。详细 为 true，则返回完整区块信息,否则只返回摘要。
    • getblockchaininfo：获取区块链的基本信息，如当前区块高度、难度、网络哈希率、同步进度等。
    • getnetworkinfo：获取比特币节点的网络连接信息，如节点数量、连接状态、协议版本等。
    • getpeerinfo：列出当前连接的所有对等节点信息。

  4. 钱包与节点控制：

    • walletlock：锁定钱包,需要密码才能进行敏感操作。
    • walletpassphrase "密码" "超时秒数"：解锁钱包,指定解锁时间。
    • stop：安全关闭 Bitcoin Core 节点。
    • getmininginfo：获取挖矿相关信息（如果节点开启了挖矿功能）。

高级应用与注意事项

  • 批量操作与脚本自动化：bitcoin-cli 命令可以结合 shell 脚本（如 Bash、PowerShell）实现批量操作和自动化流程，例如定期检查余额、批量发送小额款项等。
  • 交易构造与优化：通过 createrawtransaction 和 signrawtransactionwithwallet，用户可以精确控制交易的输入输出，实现自定义找零、设置交易费用（通过 replace-by-fee 或手动设置手续费率）、甚至创建多签交易等高级功能。
  • 隐私与安全：使用命令行操作时，务必注意环境安全，避免在公共或不安全的计算机上操作，防止私钥泄露，对于大额交易,建议先在测试网络上进行演练。
  • 性能考虑：部分命令（如涉及大量历史交易查询的）可能会对节点性能产生一定影响,尤其是在资源有限的设备上。
  • 学习资源：Bitcoin Core 的官方文档是学习命令最权威的资料，其中包含了所有命令的详细参数、返回值和示例，GitHub 上的 Bitcoin Core 仓库也提供了源码和文档。

Bitcoin Core 的命令行接口是通往比特币核心功能的强大桥梁，虽然它不像 GUI 那么直观，但对于追求更高控制力、自动化能力或进行复杂交易操作的用户而言，掌握这些命令是必不可少的，通过熟练运用 bitcoin-cli 命令，用户能够更深入地理解比特币的工作原理，更灵活地管理自己的资产，并充分发挥 Bitcoin Core 作为全节点的强大功能，初学者可以从简单的查询命令开始，逐步探索更复杂的交易和钱包管理功能,在实践中不断提升对比特币的认知和操作技能。