BSV 主网 mainnet 与测试环境有什么区别
主网承载真实价值,测试环境用于学习和开发。本文梳理 BSV mainnet 与测试环境的区别、常见风险、SDK 使用中的注意事项,以及项目配置中的分环境建议。
林知衡
technical_editor
一句话理解
主网承载真实价值,测试环境用于学习、开发和调试。写 BSV 应用时,必须明确自己正在连接哪个网络。
很多区块链事故并不是因为算法太复杂,而是因为开发者把测试代码、测试私钥或测试配置误用到了真实网络。学习 BSV 时,先分清主网和测试环境,是一项非常实际的安全要求。

什么是主网 mainnet
主网(mainnet)是真实运行的 BSV 网络。
主网上的交易具有真实经济意义。你在主网上花费 UTXO,就是在真实转移 BSV 的控制权;你把数据写上主网,也会形成公开的链上记录。
主网包含真实矿工、真实费用、真实区块、真实区块浏览器和真实用户。也正因为如此,主网上的错误通常不能简单撤销。
主网适合用于:
- 真实支付;
- 生产业务;
- 正式数据记录;
- 需要长期保存和验证的交易。
但主网不适合随意试错。任何广播到主网的交易,都应该经过充分检查。
什么是测试环境
测试环境用于开发、调试和学习。它可能是官方测试网络、私有测试网络、本地 regtest 环境,也可能是某些 SDK 或钱包提供的开发模式。
测试环境里的币通常没有真实经济价值,或者只在测试范围内有意义。它的目标不是承载真实业务,而是让开发者安全地完成试验,例如:
- 创建地址;
- 构造交易;
- 生成签名;
- 广播交易;
- 查询交易状态;
- 测试钱包接口;
- 测试应用协议。
对于新手来说,测试环境的最大价值是:允许你在低风险条件下犯错、排查问题并理解流程。
为什么新手必须先用测试环境
刚开始写 BSV 应用时,出错很正常。你可能会遇到这些问题:
- 忘记添加找零 output;
- 手续费计算错误;
- 用错私钥;
- 把数据写成错误格式;
- 重复广播交易;
- 误删钱包文件;
- 把主网地址和测试地址混在一起。
在测试环境中,这些错误主要是学习成本;在主网中,它们可能带来真实资金损失,或者造成公开数据污染。
因此,更安全的学习路径是:先在测试环境中跑通完整流程,再用极小金额在主网上验证,最后才进入正式业务场景。
网络环境会影响哪些细节
网络环境不只是一个名称,它会影响应用运行的多个关键环节:
- 地址格式;
- 钱包配置;
- API endpoint;
- 区块浏览器;
- 广播服务;
- 手续费策略;
- 可用矿工或测试节点;
- 交易确认速度;
- SDK 示例配置。
所以,不能只看代码里有没有调用 send() 或广播函数,还要确认它连接的是哪个网络。
一个清晰的项目通常会显式区分不同环境,例如:
同时,应用也应该在日志、命令行输出或界面中清楚显示当前网络,避免开发者误操作。
使用 BSV SDK 时也要有环境意识
使用 @bsv/sdk 或钱包接口时,开发者可能不需要一开始就处理所有底层网络参数,因为钱包或 SDK 会封装很多细节。
但这并不意味着网络环境不重要。你仍然需要确认:
- 钱包当前连接的是主网还是测试环境;
- 交易是否会消耗真实 BSV;
- 交易会被广播到哪里;
- 返回的 txid 应该使用哪个区块浏览器查询;
- 示例代码中是否写死了某个 endpoint。
例如,在学习 BSV TypeScript SDK 的 first transaction 示例时,不应只关注代码是否能运行,还要关注钱包、广播服务和查询工具对应的是哪个网络。
参考文档:
- BSV TypeScript SDK first transaction: https://bsv-blockchain.github.io/ts-sdk/tutorials/first-transaction/
- Wallet reference: https://bsv-blockchain.github.io/ts-sdk/reference/wallet/
- WhatsOnChain: https://whatsonchain.com/
主网数据不能随便删除
BSV 是公开链。写入链上的数据会由交易记录承载。即使某些服务不再显示,链上记录仍可能长期存在。
因此,不要在主网上写入以下内容:
- 私钥;
- 助记词;
- 身份证件;
- 真实手机号;
- 未加密隐私数据;
- 商业机密;
- 任何你未来希望删除的敏感内容。
同时,测试环境也不应放入真实隐私信息。测试服务同样可能被他人访问、索引或记录。
项目配置建议
即使只是学习项目,也建议从一开始就建立分环境习惯:
- 把网络名称写进配置文件;
- 不要在代码里硬编码私钥;
- 主网操作前打印明显提示;
- 测试钱包和主网钱包分开;
- API key 和 wallet credential 分开管理;
- 交易日志记录 txid、网络名和时间;
- 不要把
.env提交到 GitHub。
这些习惯看起来基础,但能显著降低误操作风险。越早建立,后续开发真实应用时越轻松。
新手常见误解
下面这些误解在学习阶段很常见,需要特别注意:
- 测试环境成功,不代表主网一定成功;
- 主网小额测试,也是真实资金操作;
- 区块浏览器查不到交易,可能是网络选错了;
- 同一个助记词在不同网络或路径下,可能看到不同地址;
- SDK 示例能运行,不代表可以直接用于生产;
- 测试数据也不应该包含真实隐私。
小结
主网和测试环境的区别,不只是“有没有真实币”这么简单。它会影响地址、钱包、广播、查询、费用、确认和数据可见性。
对 BSV 开发者来说,最重要的实践原则是:
- 明确当前网络;
- 测试环境先跑通;
- 主网操作前再次确认;
- 不把敏感数据写上链;
- 从一开始就做好环境隔离。
当你能清楚回答“这笔交易会发到哪里、会花谁的钱、会留下什么记录”时,再进入主网操作会更安全。
专题
BSV基础知识
第9篇 / 共43篇文章
系统整理 BSV、区块链基础概念、协议能力和生态知识的专题文章。
阅读路径
进度 9/43
- 01阅读文章第 1 篇
为什么 BSV 仍然值得关注
关于结算设计、数据持久性,以及为什么建设者仍在关注 BSV。
2026年4月30日5 分钟阅读 - 02阅读文章第 2 篇
P2P Electronic Cash:什么是点对点电子现金?
点对点电子现金是理解 Bitcoin 和 BSV 的入口。它强调通过交易、签名和公开账本直接转移数字价值,而不是依赖中心平台账户。本文解释 peer-to-peer、cash、双花、UTXO 以及 BSV 为什么重视低费用、高频交易和链上数据。
2026年5月19日15 分钟阅读 - 03阅读文章第 3 篇
时间戳服务器:区块链为什么是时间顺序记录?
区块链不只是账本,更是一台公开的时间排序机器。本文解释 Bitcoin/BSV 中 timestamp server 的含义、区块高度与确认数的作用,以及时间戳在防双花和数据存证场景中的价值。
2026年5月20日15 分钟阅读 - 04阅读文章第 4 篇
Proof of Work:矿工为什么能排序交易?
Proof of Work 通过“计算昂贵、验证便宜”的机制,让矿工在开放网络中竞争新区块,并用累积工作量决定交易历史排序。本文解释 PoW 的工作原理、矿工为何能排序交易、其安全意义,以及 BSV 在大区块、低费用和高交易量方向下的矿工经济逻辑。
2026年5月20日5 分钟阅读 - 05阅读文章第 5 篇
BSV 网络如何运转:交易、区块、手续费与矿工激励
本文用最基础的视角解释 BSV 网络的运行机制:交易如何构成、区块如何组织、矿工如何获得激励,以及为什么 BSV 特别强调低手续费、大区块和高吞吐链上交易。
2026年5月20日15 分钟阅读 - 06阅读文章第 6 篇
SPV 入门:轻客户端为什么不需要下载全链
SPV(简化支付验证)让轻客户端无需下载完整区块链,也能验证某笔交易是否被包含在区块中。本文解释 SPV 的工作原理、Merkle proof 的作用、它能证明什么、不能证明什么,以及为什么 SPV 是 BSV 架构中的核心能力。
2026年5月20日15 分钟阅读 - 07阅读文章第 7 篇
BSV 与 BTC/BCH 的路线差异:为什么强调链上扩容、低费和企业数据
BTC、BCH、BSV 都源自 Bitcoin,但技术路线明显不同。本文从链上扩容、低费用、稳定协议、SPV、企业数据和现实挑战出发,系统解释 BSV 为什么选择低费高量和大规模链上扩展路线。
2026年5月20日15 分钟阅读 - 08阅读文章第 8 篇
WIF、助记词与 HD Wallet:BSV 钱包密钥管理入门
WIF、助记词和 HD Wallet 都与密钥保存、恢复和派生有关,但含义不同。本文解释它们的区别、xpub 的作用,以及在 BSV 钱包和应用开发中的安全实践。
2026年5月20日25 分钟阅读 - 09阅读文章第 9 篇当前
BSV 主网 mainnet 与测试环境有什么区别
主网承载真实价值,测试环境用于学习和开发。本文梳理 BSV mainnet 与测试环境的区别、常见风险、SDK 使用中的注意事项,以及项目配置中的分环境建议。
2026年5月24日5 分钟阅读 - 10阅读文章第 10 篇
钱包不是账户系统:BSV 钱包管理的是密钥和 UTXO
BSV 钱包不是传统账户系统。链上没有单一余额字段,钱包通过管理私钥、UTXO、交易构造和签名来计算余额并发起交易。理解这一点,有助于正确认识找零、多输入、非托管钱包和应用授权等关键概念。
2026年5月24日15 分钟阅读 - 11阅读文章第 11 篇
BRC-100:钱包与应用之间的标准接口
BRC-100 是 BSV 生态中描述应用与钱包如何通信的接口标准。它强调应用表达业务意图,钱包保留密钥控制权,帮助非托管应用以更安全、统一的方式请求创建交易、签名和返回结果。
2026年5月24日8 分钟阅读 - 12阅读文章第 12 篇
Transaction Input 是什么:理解 BSV 交易输入与 UTXO 引用
Transaction input 是 BSV 交易的资金来源,它引用上一笔交易中的某个未花费 output,并提供解锁数据。理解 input 有助于掌握 UTXO 模型、outpoint、双花冲突、手续费计算和交易调试。
2026年5月26日15 分钟阅读 - 13阅读文章第 13 篇
理解 BSV Transaction Output:金额、Locking Script 与 UTXO
Transaction output 是 BSV 交易创建的新价值单元,通常由金额和 locking script 组成。它既可以表示付款和找零,也可以承载 OP_RETURN 数据、token 状态或业务记录。理解 output、UTXO 和 output index,是理解 BSV 交易与应用协议设计的基础。
2026年5月26日15 分钟阅读 - 14阅读文章第 14 篇
TXID 是什么:BSV 交易唯一标识的作用、误区与设计建议
TXID 是 BSV 中最常见的交易标识,可用于查询交易、引用 output、保存业务记录和构建 SPV 证明。但 TXID 标识的是整笔交易,不等于 output,也不代表交易已最终完成。实际应用中应结合 output index、状态、raw transaction 和证明材料一起保存。
2026年5月26日15 分钟阅读 - 15阅读文章第 15 篇
理解 BSV 交易中的找零 output:为什么它必须显式写入交易
找零 output 是 BSV UTXO 模型中的关键概念:旧 UTXO 必须整体花费,未用完的金额需要通过新的 output 退回给付款方。本文解释找零的工作方式、手续费关系、找零地址、隐私影响以及 UTXO 管理中的实践问题。
2026年5月26日15 分钟阅读 - 16阅读文章第 16 篇
BSV 交易手续费如何计算:输入总额减去输出总额
BSV 交易手续费不是独立字段,而是输入总额减去输出总额。理解这个规则有助于正确处理找零、估算费用、管理 UTXO,并避免把余额误作为手续费。
2026年5月26日15 分钟阅读 - 17阅读文章第 17 篇
什么是 raw transaction:BSV 交易序列化、TXID 与签名的基础
raw transaction 是交易按协议规则序列化后的原始字节表示,通常以十六进制字符串展示。它关系到 TXID、签名、广播和调试,是理解 BSV 交易底层机制的关键概念。
2026年5月26日10 分钟阅读 - 18阅读文章第 18 篇
BSV 交易调试中的 Endian 问题:为什么 TXID 看起来会反过来
Endian 是 BSV 交易调试中常见的字节序问题,尤其容易出现在 raw transaction、TXID、outpoint、数字字段和 Merkle proof 中。理解显示格式与底层序列化字节的区别,可以避免很多“TXID 不匹配”或“proof 算错”的误判。
2026年5月26日12 分钟阅读 - 19阅读文章第 19 篇
什么是 UTXO:理解 BSV 交易模型的基础
UTXO 是“未花费交易输出”,是 BSV 交易模型的基本单位。钱包余额并不是链上的账户字段,而是一组可控制 UTXO 的金额总和。理解 UTXO,有助于理解 BSV 的 input、output、找零、手续费、双花、Script 以及并行处理。
2026年5月27日15 分钟阅读 - 20阅读文章第 20 篇
在 BSV 中,花钱就是消耗旧 UTXO、创造新 UTXO
在 BSV 中,花钱不是修改余额,而是消耗旧 UTXO、创建新 UTXO。理解这一点,有助于掌握付款、找零、交易链以及 token 和应用状态转移的基本逻辑。
2026年5月27日12 分钟阅读 - 21阅读文章第 21 篇
一个地址可以有很多 UTXO:理解 BSV 中的地址、余额与交易构造
在 BSV 的 UTXO 模型中,一个地址不是账户,也不是单一余额槽。同一个地址可以关联多个 UTXO,钱包余额只是这些 UTXO 的汇总。理解这一点,有助于正确处理交易构造、手续费、UTXO 碎片化和隐私问题。
2026年5月27日5 分钟阅读 - 22阅读文章第 22 篇
UTXO 模型为什么适合并行处理?——BSV 扩容的技术基础
UTXO 模型将状态拆分为独立输出,使得交易验证可以并行进行,为 BSV 的链上扩容和高吞吐提供了关键数据结构基础。本文对比账户模型与 UTXO 模型,解释并行性原理、实际限制以及与 Teranode 和应用设计的关系。
2026年6月2日3 分钟阅读 - 23阅读文章第 23 篇
理解比特币双花问题:为什么同一个 UTXO 不能被花两次
双花是数字现金系统的核心问题。本文用通俗语言解释双花的原理、交易结构、矿工作用、0-conf 风险、签名与双花的关系,以及工程实践中的注意事项。
2026年6月2日3 分钟阅读 - 24阅读文章第 24 篇
理解 BSV 中的 Locking Script:花费条件的核心机制
Locking script 是 BSV 交易中不可或缺的部分,它定义了 UTXO 的花费条件。本文从基础概念出发,逐步解析 locking script 的位置、与地址的关系、表达方式及其在应用中的重要性。
2026年6月2日3 分钟阅读 - 25阅读文章第 25 篇
深入理解 Unlocking Script:区块链交易的“开锁证据”
Unlocking Script 是交易输入中的解锁材料,用于满足上一笔输出的锁定条件。本文从概念、位置、工作原理到常见误解,全面解析这一关键机制。
2026年6月2日3 分钟阅读 - 26阅读文章第 26 篇
P2PKH:BSV 中最常见的支付脚本模板详解
P2PKH(Pay to Public Key Hash)是 Bitcoin/BSV 中最基础的普通支付脚本。本文拆解其核心逻辑、工作流程、与地址的关系、解锁条件,并解释为什么 BSV 开发者需要理解它。
2026年6月2日2 分钟阅读 - 27阅读文章第 27 篇
OP_RETURN:BSV链上数据写入入门
了解OP_RETURN的基本概念、与普通支付的区别、数据格式要求、隐私注意事项以及应用场景。
2026年6月2日2 分钟阅读 - 28阅读文章第 28 篇
解读Bitcoin Script:基于栈的脚本语言及其执行模型
Bitcoin Script是一种基于栈执行的脚本语言,用于验证交易花费条件。本文从栈的概念出发,通过例子说明其执行过程,并探讨P2PKH、受限设计、BSV应用等关键点,帮助理解这一链上验证语言的核心机制。
2026年6月2日2 分钟阅读 - 29阅读文章第 29 篇
标准脚本 vs 非标准脚本:BSV 开发中容易被忽略的边界
共识上有效的交易,网络不一定处理。理解标准脚本与矿工策略,避免交易广播失败。
2026年6月2日3 分钟阅读 - 30阅读文章第 30 篇
从零开始使用 @bsv/sdk:安装、验证与第一步
介绍 @bsv/sdk 的安装、项目搭建与验证过程,帮助开发者快速进入 BSV 开发环境,理解 SDK 在技术栈中的角色。
2026年6月15日3 分钟阅读 - 31阅读文章第 31 篇
WalletClient:应用与钱包之间的通信入口
WalletClient 是 BSV 应用中连接钱包的标准化客户端,它让应用描述交易意图,钱包负责授权、签名和 UTXO 管理,从而隔离私钥、UTXO 和签名等复杂度。
2026年6月15日3 分钟阅读 - 32阅读文章第 32 篇
使用 createAction() 创建你的第一笔 BSV 交易:入门指南
createAction() 是 BSV SDK 的核心方法,让应用通过高级接口描述交易动作,钱包自动处理签名、费用和广播。本文带你理解其原理、参数和实际用法。
2026年6月15日3 分钟阅读 - 33阅读文章第 33 篇
自动选择 inputs、找零和手续费:钱包如何为你构建完整交易
使用高级SDK时,钱包可以自动选择可花费的UTXO、生成找零output并计算手续费。本文解释这一过程的工作原理、益处和潜在风险。
2026年6月15日3 分钟阅读 - 34阅读文章第 34 篇
将数据写入 BSV 区块链:从 OP_RETURN 到应用协议
BSV 交易不仅能转移 satoshis,还能通过数据输出将文本、哈希或业务事件写入链上。本文从第一笔 Hello BSV 交易讲起,介绍数据输出与支付输出的区别、如何使用 SDK 构造 OP_RETURN、十六进制转换原因,以及如何走向结构化协议设计。
2026年6月16日2 分钟阅读 - 35阅读文章第 35 篇
用 WhatsOnChain 查看 BSV 交易:从 txid 到链上结构的完整指南
本文教你如何使用区块浏览器 WhatsOnChain 查看交易详情,理解 inputs、outputs、脚本、手续费等核心概念,并借助浏览器反向理解 SDK 的底层逻辑。
2026年6月16日3 分钟阅读 - 36阅读文章第 36 篇
BSV 交易入门:手动指定输入(Inputs)的正确姿势
在 BSV 的 UTXO 模型中,手动指定交易输入是进阶开发的必备技能。本文深入解析输入的本质、所需信息、代码示例和常见误区,帮你避开“地址扣款”的思维陷阱。
2026年6月18日3 分钟阅读 - 37阅读文章第 37 篇
手动指定交易输出,掌握 BSV 应用设计的关键一步
理解比特币交易输出(output)的机制,从手动构造交易开始。本文介绍输出的类型、找零规则、索引顺序及常见误区,帮助你从“会发交易”进阶到“会设计 BSV 应用”。
2026年6月18日2 分钟阅读 - 38阅读文章第 38 篇
比特币交易手续费:计算方式、影响因子与BSV实践指南
交易手续费并非显式字段,而是输入总额与输出总额的差额。理解手续费计算逻辑、交易大小的影响因素以及BSV网络策略,是构建链上应用的基础。
2026年6月18日3 分钟阅读 - 39阅读文章第 39 篇
为什么比特币交易的每个输入都需要单独签名?
理解比特币交易中多输入签名的必要性,避免常见误解,并了解 P2PKH 签名的基本逻辑、SDK 使用方法以及签名保护的具体内容。
2026年6月18日3 分钟阅读 - 40阅读文章第 40 篇
BSV 交易序列化:从对象到广播的必经之路
理解交易序列化是连接应用开发与区块链网络的关键。本文介绍为何需要序列化、标准交易结构、hex 的作用、SDK 中的序列化与反序列化、txid 关系以及常见误区,帮助你从调 SDK 进阶到调试链上数据。
2026年6月18日3 分钟阅读 - 41阅读文章第 41 篇
BSV 交易广播:从构造到提交的完整指南
在 BSV 开发中,构造交易只是第一步。本文详细讲解广播交易的意义、常见误区、广播前检查、返回值处理及失败原因,帮助开发者正确将交易提交至网络。
2026年6月18日2 分钟阅读 - 42阅读文章第 42 篇
交易链:一笔交易怎样花掉刚刚生成的 UTXO
理解交易链,才能真正理解比特币白皮书中“coin 是一条数字签名链”的含义。本文从最小模型出发,介绍 UTXO 在交易之间如何转移,以及交易链在 BSV 应用状态管理中的关键作用。
2026年6月18日3 分钟阅读 - 43阅读文章第 43 篇
比特币区块头:SPV和轻客户端的80字节基石
区块头是比特币区块的80字节摘要,虽不包含完整交易,却是连接工作量证明链和承诺交易集的关键结构。本文解释区块头字段、Merkle root和SPV原理,帮助理解BSV大规模扩展的实现基础。
2026年6月20日4 分钟阅读
推荐文章
区块链2026年5月24日
钱包不是账户系统:BSV 钱包管理的是密钥和 UTXO
BSV 钱包不是传统账户系统。链上没有单一余额字段,钱包通过管理私钥、UTXO、交易构造和签名来计算余额并发起交易。理解这一点,有助于正确认识找零、多输入、非托管钱包和应用授权等关键概念。
区块链2026年5月20日
WIF、助记词与 HD Wallet:BSV 钱包密钥管理入门
WIF、助记词和 HD Wallet 都与密钥保存、恢复和派生有关,但含义不同。本文解释它们的区别、xpub 的作用,以及在 BSV 钱包和应用开发中的安全实践。
区块链2026年5月24日
BRC-100:钱包与应用之间的标准接口
BRC-100 是 BSV 生态中描述应用与钱包如何通信的接口标准。它强调应用表达业务意图,钱包保留密钥控制权,帮助非托管应用以更安全、统一的方式请求创建交易、签名和返回结果。