Ganache

什么是 Ganache？

Ganache 是一款本地区块链模拟器，开发者无需使用真实加密货币，即可构建、部署、测试和调试兼容 Ethereum 的智能合约。它会在开发者的计算机上创建一个私有区块链环境，并模拟 Ethereum 虚拟机（通常称为 EVM）的许多重要行为。开发者可以使用 Ganache 创建测试账户、部署 Solidity 合约、发送交易、查看区块、测量 Gas 用量，以及观察区块链状态变化。

已归档的Ganache 官方文档将 Ganache 描述为个人区块链，可在安全且结果确定的环境中快速开发去中心化应用。

Ganache 曾广受欢迎，因为开发者无需运行完整的公共区块链节点或获取测试加密货币，就能立即开始测试。交易可以即时确认，账户可以获得大量模拟 ETH，整个区块链也可以根据需要随时重置。Ganache 提供图形桌面应用、命令行界面，以及可嵌入开发工作流的 JavaScript 软件包。Ganache 不是加密货币、公共区块链、钱包、代币或去中心化交易平台。它是一款开发软件，旨在受控的本地网络中模拟区块链行为。

Ganache 仍在维护吗？

Ganache 已不再积极维护。Consensys 于 2023 年 9 月 21 日宣布停止维护 Ganache 及更广泛的 Truffle 开发套件。

官方的Ganache 停止维护公告表示，过渡期结束后，代码仍将公开提供。

Ganache 源代码仓库于 2024 年 2 月 26 日归档，目前为只读状态。

只要环境支持其依赖项和预期的 Ethereum 规则，已归档软件仍可能可以使用。不过，已归档软件通常不会获得新功能、安全补丁、依赖项更新、错误修复，也不会支持后续网络升级。这一限制很重要，因为 Ethereum 会持续引入新的操作码、交易格式、Gas 规则、账户功能和执行变更。较新的 Solidity 合约可能使用旧版本 Ganache 无法识别的指令。如果 Ganache 模拟的是较早的协议规则，那么在 Ganache 中通过所有测试的合约，在当前公共区块链上的行为也可能有所不同。因此，应将 Ganache 视为旧版 Ethereum 开发软件，而不是当前生产环境测试的标准工具。

Ganache 如何运作？

Ganache 会启动一个由开发者控制的隔离区块链进程。该进程维护本地账户、余额、区块、交易、智能合约代码、存储、日志及其他区块链状态。它会提供兼容 Ethereum 的 JSON-RPC 端点，供开发脚本、钱包、浏览器应用和测试工具连接。

Ethereum JSON-RPC 文档介绍了应用与 Ethereum 执行客户端通信时使用的标准接口。

交易发送至 Ganache 后，模拟器会验证请求、执行相关 EVM 指令、更新本地状态，并返回交易回执。Ganache 可以在收到交易后立即创建新区块，也可以按照设定的时间间隔挖矿。由于区块链由开发者控制，因此无需与其他用户竞争公共区块空间。开发者还可以重启区块链、更改配置、更换账户或清除历史记录。这些控制让 Ganache 运行快速且结果可预测，但也使其与去中心化公共区块链有本质区别。

什么是个人区块链？

个人区块链是用于开发、教育或测试的私有区块链环境。它不像 Ethereum 主网那样由一组分布式且经济利益相互独立的验证者来保障安全。运行区块链的人可以控制其初始状态、账户、挖矿行为、时间戳和网络设置。运营者通常无需获得其他网络参与者批准，就能重置或改写本地环境。这种灵活性让开发者能够在相同条件下重复执行测试。但这也意味着，个人区块链无法复现公共加密网络的经济安全性、去中心化程度、网络拥堵、交易排序或恶意活动。Ganache 更适合被称为个人区块链模拟器，而非生产区块链。

Ganache 账户与模拟 ETH

通常，Ganache 本地区块链启动时会创建多个测试账户。每个账户通常都会获得大量模拟 ETH。这些 ETH 可用于支付模拟 Gas 费、部署合约、转移价值，以及在 Ganache 内与去中心化应用交互。Ganache ETH 只存在于本地区块链数据库中，因此没有市场价值。它无法通过区块链协议直接转入 Ethereum 主网，也无法兑换成真实加密货币。Ganache 可以通过确定性助记词生成账户。在另一个 Ganache 会话中使用相同的助记词、派生路径和配置，可以生成相同的地址和私钥。确定性账户很有用，因为自动化测试可以在开始前确定将使用哪些地址和余额。这些账户专为开发而设计，因此其私钥可以直接访问。切勿将真实钱包助记词或生产环境私钥输入 Ganache。开发用密钥也绝不能用于将存放有价值加密货币的公共网络地址。

Ganache 图形界面

Ganache 图形界面提供了创建和查看个人区块链的可视化方式。账户页面会显示本地地址、余额、交易数量和私钥。区块和交易页面允许开发者查看本地挖出的活动记录。如果提供了项目信息，合约相关页面还可以显示已部署合约、事件、存储信息和执行详情。该界面让仍在学习区块链命令行工具的开发者也能使用 Ganache。用户可以创建具有不同账户、挖矿、网络和分叉配置的工作区。

已归档的Ganache 快速入门指南介绍了过去通过桌面应用创建个人区块链的流程。

图形界面现已成为旧版软件，不应期待其支持当前 Ethereum 功能。

Ganache 命令行界面

Ganache 命令行界面允许开发者通过终端启动并配置本地区块链。

旧版安装通常可以通过类似

的命令启动。

命令行操作适用于自动化测试、脚本、开发服务器和持续集成环境。开发者可以配置账户、余额、助记词、链标识符、Gas 上限、挖矿间隔、日志、数据库、服务器端口和网络分叉。

已归档的Ganache CLI 选项参考记录了 Ethereum 开发者过去可用的配置类别。

命令行程序还可以在分离模式下启动，让本地区块链脱离原始终端命令继续运行。由于软件包已归档，在现代软件环境中安装时可能出现依赖项、操作系统或运行时兼容问题。

Ganache 工作区

Ganache 工作区用于保存特定本地区块链项目的配置。工作区可以定义账户、助记词、链设置、挖矿行为、数据库路径和关联的智能合约项目。持久化工作区可以在应用关闭后保留区块链历史和已部署合约状态。临时工作区则可以在每次 Ganache 重启时从干净状态开始。持久化本地状态在开发期间很方便，但也可能导致不同测试运行之间的 nonce、部署或余额差异令人困惑。与其使用包含早期交易的旧本地数据库，自动化测试通常更适合在干净且具有确定性的环境中运行。

Ganache 的即时挖矿

Ganache 可以在收到交易后立即挖出区块，从而即时确认交易。与公共区块链相比，即时挖矿能显著加快智能合约测试套件的运行速度。开发者可以部署合约并与之交互，无需等待公共区块的生成间隔。Ganache 也可以设置为按固定时间间隔挖矿。手动挖矿控制允许测试先创建待处理交易，再决定何时生成区块。这些功能有助于测试区块链应用，但即时挖矿可能掩盖与延迟、手续费竞争、替换交易和状态变化有关的生产环境问题。去中心化应用绝不能仅仅因为交易在 Ganache 中即时确认，就假设真实交易也会立即确认。

Ganache 快照与回滚

Ganache 支持为本地区块链当前状态创建快照。开发者可以创建快照、执行若干笔交易，然后将区块链恢复到保存的状态。借助此功能，测试可以反复从相同的账户余额、合约存储、时间戳和区块历史开始。快照减少了在每项测试前重新部署所有合约的需要。快照也有助于开发者根据已知区块链状态重现错误。Ganache 快照只是本地测试功能，不会影响公共区块链。用户无法通过 Ganache 快照命令撤销已最终确认的 Ethereum 主网交易。

Ganache 时间调整

Ganache 允许开发者推进区块链时间并控制本地生成区块的时间戳。此功能适用于测试代币归属期、质押计划、治理周期、拍卖、贷款期限、订阅系统和时间锁合约。开发者可以模拟数月时间流逝，无需等待现实时间过去。测试还可以检查到期时间前后的行为。公共 Ethereum 时间戳由网络规则生成，应用开发者无法控制。因此，合约测试应涵盖现实的时间戳变化，而不应只测试完全可预测的本地数值。

Ganache 网络分叉

Ganache 可以创建兼容 Ethereum 的公共网络本地分叉。分叉从选定远程区块中的账户、余额、合约代码和存储状态开始。从该起点开始，新交易会在本地执行，不会修改原始公共区块链。分叉允许开发者测试与现有代币、去中心化协议或已部署合约系统的交互。它也有助于在类似问题发生时的区块链条件下重现历史错误。通常需要远程 JSON-RPC 端点来获取复制的区块链状态。当本地执行的交易访问尚未下载的状态时，Ganache 可以向该远程节点请求更多信息。分叉测试并不意味着开发者可以控制真实资产，因为复制的余额和合约状态仅存在于模拟器中。如果遇到不支持的区块、交易、操作码或协议变更，已归档的 Ganache 版本可能无法正确分叉当前网络。

Ganache 分叉中的账户模拟

Ganache 可以在分叉环境中本地解锁或模拟指定区块链地址。这样，测试便可以模拟由特定代币持有者、管理员、治理参与者或合约账户发送交易。模拟账户不会泄露该地址的真实私钥。它也不会赋予用户控制原始公共网络上该地址的权限。此功能之所以可用，仅仅是因为开发者控制本地模拟器，并可以更改其授权规则。账户模拟适用于测试复杂场景，但生产交易仍必须遵守真实网络规则并取得有效授权。

Ganache 与智能合约部署

开发者可以通过向 Ganache 本地 JSON-RPC 端点发送合约创建交易，将编译后的 Solidity 合约部署到 Ganache。交易中包含创建字节码及编码后的构造函数参数（如有）。Ganache 会执行构造函数，并将生成的运行时字节码存储在本地合约地址上。之后，脚本、钱包、浏览器应用或其他本地合约就可以调用该合约。在 Ganache 上成功部署，并不代表合约已部署到 Ethereum 主网或公共测试网。每条区块链都有独立的合约状态和交易历史。从本地测试转向公共网络时，需要单独发送部署交易并支付网络手续费。

使用 Ganache 测试加密货币代币

开发者可以使用 Ganache 创建并测试本地同质化代币、NFT、治理代币、稳定价值系统、质押合约及其他加密应用。开发者可以测试转账、余额、授权额度、批准、铸造、销毁、所有权、访问控制和事件日志。本地账户可以免费获得模拟代币。连接到 Ganache 的钱包在添加正确的本地合约地址后，可以显示本地代币。该代币只存在于特定的 Ganache 区块链上。重置区块链可能会删除该代币、其余额及完整交易历史。本地代币即使使用真实加密货币的名称或代码，也仍然只是模拟资产。区块链和合约地址是比显示名称或代码更可靠的代币标识信息。

Ganache Gas 费

Ganache 会模拟 EVM Gas，让开发者查看合约部署和函数调用的执行成本。存储写入、调用数据、事件日志、合约创建、外部调用和计算操作都可能影响显示的 Gas 用量。模拟费用从测试账户的本地 ETH 余额中扣除。执行普通的 Ganache 本地交易不会消耗真实 ETH。开发者可以配置 Gas 价格、区块 Gas 上限、交易上限和其他费用相关设置。这种灵活性有助于测试 Gas 不足错误和成本较高的合约函数。但如果模拟器使用的是旧版 EVM 或过时的 Gas 规则，Ganache 的 Gas 测量值可能无法准确反映当前 Ethereum 的情况。应在受维护且支持目标网络升级和预期部署编译器版本的环境中重新进行 Gas 基准测试。

Ganache 与确定性测试

确定性测试是指相同的初始条件和交易输入应产生相同的预期结果。Ganache 支持确定性账户、余额、区块生成、链标识符和部署顺序。测试套件可以使用已知助记词启动 Ganache，按固定顺序部署合约，并预测生成的本地地址。之后，可以在下一轮测试前重置区块链。这种可预测性有助于开发者确认代码变更是否改变了合约行为。公共区块链的可预测性较低，因为其他用户可以改变共享合约状态、交易顺序、Gas 需求、流动性和时间戳。因此，确定性的本地测试应与更全面的集成测试和对抗性测试结合使用。

Ganache 与 Ethereum 主网

Ethereum 主网是公共去中心化区块链，ETH、代币和智能合约可能具有真实金融价值。Ganache 是由本地用户控制的模拟环境，运营者可以更改余额、区块时间、账户和历史记录。主网交易需要竞争有限的区块空间，手续费则由当前网络状况决定。Ganache 可以使用即时挖矿和可配置的费用设置。主网上的活动来自世界各地的用户和应用，难以预测。新的 Ganache 区块链只包含开发者添加的账户、合约和交易。主网安全依赖更广泛的 Ethereum 协议和验证者网络。Ganache 的安全性则取决于由单一运营者控制的本地计算机和配置。通过 Ganache 测试并不能证明合约安全，也不能证明其兼容当前主网行为。

Ganache 与公共测试网

公共测试网是由众多参与者共同运行的开发区块链。

Ethereum 开发网络指南介绍了本地环境与共享公共测试网络之间的差异。

公共测试网能够更真实地呈现网络通信、区块生成、交易竞争以及与独立部署合约的交互。Ganache 则提供更快的执行速度、免费的本地余额、完全控制权和即时状态重置功能。本地测试通常更适合快速单元测试，而受维护的公共测试网则可提供更充分的集成测试。测试网加密货币同样没有预期的金融价值，不过它存在于共享网络，而非单个开发者的计算机上。对于将控制有价值加密资产的合约，无论是本地测试还是公共测试网测试，都不能替代专业安全审查。

Ganache 与私有 Ethereum 网络

私有 Ethereum 网络可以由多个执行节点和共识节点组成，这些节点互相连接，但不加入 Ethereum 主网。Ganache 通常通过更简单、侧重开发的进程模拟区块链执行。多节点私有网络可以测试点对点通信、区块传播、同步、共识行为和节点故障。Ganache 则更侧重快速应用开发、可预测账户、本地 RPC 访问和便捷的测试控制。

Geth 私有网络文档介绍了私有 Ethereum 网络如何支持多节点和多用户测试场景。

因此，高级协议测试可能需要多客户端网络，而不是单个 Ganache 进程。

Ganache 的局限性

Ganache 无法复现 Ethereum 主网完整的经济、网络、共识和对抗性环境。即时确认可能掩盖与待处理交易、基础费用变化、nonce 冲突或替换规则有关的问题。可预测的交易排序可能掩盖抢先交易、尾随交易、强制平仓竞争及其他交易排序风险。无限测试资金可能掩盖账户充值和用户引导方面的问题。本地网络不会自动包含真实预言机、跨链桥、流动性池、代币、治理系统或其他外部合约。分叉可以加入复制的公共状态，但仍无法复现模拟与生产执行之间可能发生的所有事件。Ganache 已归档，因此当前编译器的输出或 Ethereum 行为可能不受支持，这带来了额外风险。完整的测试流程应包括受维护的本地工具、共享网络测试、安全分析、模糊测试以及部署配置审查。

Ganache 的安全风险

Ganache 账户并非为保护有价值的加密货币而设计。其私钥可能会显示在终端输出或图形界面中、存储在项目文件里，或根据广为人知的默认助记词生成。Ganache RPC 服务器可以开放强大的开发功能，绝不能向不受信任的互联网用户开放。将本地开发服务器绑定到公共网络接口可能造成不必要的安全风险。分叉的区块链数据可能显示真实账户余额，但这些本地余额不能证明运营者控制着原始资产。为 Ganache 编写的脚本可能包含快捷做法，如果将其用于生产环境密钥，会带来危险。开发凭证与生产凭证必须完全隔离。任何网站、测试环境或客服人员都不需要真实助记词来创建本地 Ganache 区块链。

Ganache 常见错误

如果应用使用了错误的 RPC 主机、端口或协议，可能会出现连接错误。如果钱包配置的本地网络不同，可能会出现链标识符错误。如果钱包仍记有此前 Ganache 会话中的交易，而该会话已重置，可能会出现 nonce 错误。如果所选地址并非已注资的本地账户之一，可能会出现余额不足错误。交易 Gas 上限过低，或合约执行路径所需计算量超出预期，都可能导致 Gas 不足错误。不支持的操作码错误可能表明合约针对比 Ganache 所支持版本更新的 EVM 版本编译。远程 RPC 端点不可用、区块数据不兼容、速率受限或协议行为不受支持，都可能导致分叉错误。部署者、nonce、助记词或部署顺序不同，可能导致合约地址与预期不符。

Ganache 还能使用吗？

如果已归档版本能够在开发者的环境中正确安装和运行，仍然可以使用 Ganache。它可能仍有助于重现旧项目的测试结果，或了解过去的 Ethereum 开发流程。旧项目可以固定 Ganache 软件包、运行时、编译器和依赖项版本，以保持结果可复现。不过，软件仍能运行并不意味着它是最新、安全或兼容现代 Ethereum 的。维护有价值应用的团队应将所有旧版测试套件与受积极维护的 EVM 实现测试结果进行比较。新开发项目不应进一步依赖不受支持的模拟器，造成长期依赖。

从 Ganache 迁移

迁移应从记录项目使用的确切 Ganache 设置开始。重要设置包括助记词、账户数量、账户余额、链 ID、网络 ID、RPC 端口、挖矿模式、Gas 上限、时间戳、数据库路径和分叉配置。团队应找出使用 Ganache 专属 RPC 方法的测试，例如快照、时间调整、挖矿、余额调整或账户模拟。必须在替代本地环境中配置相应功能。应测试部署脚本，因为 Gas 估算、交易回执、错误消息和挖矿行为可能有所不同。Gas 快照应重新生成，而不是沿用 Ganache 的测试结果。应使用当前节点和兼容目标部署网络的 EVM 版本重新运行分叉测试。最终迁移应在保留功能行为的同时，更好地支持当前 Ethereum 协议规则。

现代本地 Ethereum 开发

当前 Ethereum 开发指南建议使用受维护的本地开发网络和框架来编写、测试和调试智能合约。

官方Ethereum 开发网络文档列出了当前可用的本地测试选项。

需要贴近实际执行客户端行为的开发者，也可以使用 Geth 创建开发链。

Geth 开发模式指南介绍了如何启动本地 Ethereum 网络并在其中部署合约。

高级团队可以使用可配置的多客户端测试网络，测试网络通信、共识和客户端兼容性。最佳环境取决于编程语言、编译器、EVM 目标、测试框架、分叉需求和部署网络。

Ganache 有代币吗？

Ganache 没有官方加密货币或在市场交易的代币。Ganache 内使用的模拟 ETH 只是本地开发数据。不应认为名称为 Ganache 的代币与已归档的开发软件有关。任何人都可以创建代币，并为其指定熟悉的软件或公司名称。用户应通过区块链和准确的合约地址识别加密货币，而不能只看名称或徽标。如果有人声称 Ganache 测试 ETH 可以购买、提现或兑换成真实 ETH，这可能是诈骗警示信号。

常见问题

简单来说，什么是 Ganache？

Ganache 是一款本地 Ethereum 区块链模拟器，用于测试智能合约和去中心化应用，无需花费真实加密货币。

Ganache 仍在维护吗？

没有。Ganache 于 2023 年停止维护，其公开源代码仓库于 2024 年归档。

现在还能安装 Ganache 吗？

已归档的软件包在兼容环境中可能仍可安装，但它们属于不受支持的旧版软件。

Ganache 是真实的加密货币区块链吗？

Ganache 会维护本地区块、交易、账户和合约，但它不是去中心化的公共加密货币网络。

Ganache 使用真实 ETH 吗？

不使用。Ganache 账户使用模拟 ETH，其价值仅存在于本地开发区块链中。

Ganache ETH 可以发送到 Ethereum 主网吗？

不可以。本地 Ganache 余额并不存在于 Ethereum 主网上，也无法提取到主网。

Ganache 有官方代币吗？

没有。Ganache 是开发软件，没有官方的市场交易加密货币。

钱包可以连接 Ganache 吗？

可以。兼容 Ethereum 的钱包可以通过 Ganache RPC 端点和正确的本地链配置进行连接。

Ganache 可以部署 Solidity 智能合约吗？

可以。编译后的 Solidity 合约可以部署到 Ganache 的本地 EVM 并在其中执行。

Ganache 可以测试代币和 NFT 吗？

可以。开发者可以部署和测试本地代币转账、批准、铸造、销毁、所有权及权限逻辑。

什么是 Ganache CLI？

Ganache CLI 是本地区块链模拟器的命令行版本。

什么是 Ganache 图形界面？

它是用于可视化显示账户、区块、交易、合约、事件和配置设置的桌面应用。

什么是 Ganache 工作区？

工作区是保存的 Ganache 配置，包含本地区块链、账户、挖矿和项目设置。

什么是 Ganache 快照？

快照会记录本地区块链状态，以便测试之后恢复到相同的起始状态。

Ganache 可以更改区块链时间吗？

可以。Ganache 开发方法可以推进时间并修改本地区块时间戳，以供测试。

什么是 Ganache 分叉？

Ganache 分叉会根据从选定公共网络区块复制的账户和合约状态创建本地区块链。

Ganache 分叉交易会影响公共网络吗？

不会。分叉后的交易会留在本地模拟器中。

Ganache 可以模拟公共地址吗？

Ganache 可以在本地模拟由指定地址发起的交易，但不会泄露私钥，也不会赋予用户控制真实资产的权限。

Ganache 会计算 Gas 吗？

会。Ganache 会根据其已归档版本实现的 EVM 规则模拟 Gas 用量和费用。

Ganache 的 Gas 估算对当前 Ethereum 准确吗？

不一定，因为它可能不支持较新的 Ethereum 升级和编译器输出。

Ganache 为什么会提示操作码不受支持？

合约可能针对某个 EVM 版本编译，而该版本包含已安装的 Ganache 版本尚未实现的指令。

Ganache 和 Ethereum 主网一样吗？

不一样。主网是拥有真实资产的去中心化公共网络，而 Ganache 由本地开发者控制。

Ganache 和公共测试网一样吗？

不一样。公共测试网由众多参与者共享，而普通 Ganache 区块链在一套开发系统中私下运行。

Ganache 可以离线使用吗？

基础本地 Ganache 区块链可以离线运行，但网络分叉需要访问远程节点。

Ganache 适合生产环境吗？

不适合。测试密钥可能暴露、历史记录可被控制、RPC 方法属于开发用途，而且软件已不再维护，因此不适合用于生产环境资产托管。

应该将真实助记词导入 Ganache 吗？

不应该。绝不能在本地开发模拟器中使用真实助记词或生产环境私钥。

旧项目可以继续使用 Ganache 吗？

旧项目可以固定版本以用于历史测试，但建议迁移到受维护的环境。

开发者为什么应从 Ganache 迁移？

迁移可以获得当前协议支持、依赖项维护、安全修复，以及与现代 Solidity 输出的兼容性。

通过 Ganache 测试能证明合约安全吗？

不能。本地测试无法替代对抗性测试、当前网络集成测试、代码审查或独立的智能合约审计。

总结

Ganache 是一款具有重要历史意义的本地区块链模拟器，曾帮助 Ethereum 开发者快速构建和测试智能合约。它提供已注资账户、确定性密钥、即时挖矿、快照、时间控制、本地 Gas 记账、网络分叉和账户模拟功能。模拟 ETH 和代币只存在于本地区块链中，没有真实市场价值。Ganache 与 Ethereum 主网不同，因为账户、区块生成、历史记录和网络状况都由单个开发者控制。它也不同于公共测试网，因为其状态通常是私有的、可预测的，并且易于重置。Ganache 于 2023 年正式停止维护，其源代码仓库于 2024 年变为只读。已归档版本可能仍适用于维护旧项目，但不应期待它支持当前 Ethereum 升级或编译器行为。开发者绝不能使用真实私钥、将 Ganache RPC 服务器公开，或把本地测试成功视为生产环境安全性的证明。从 Ganache 迁移的项目，应在受维护的替代环境中保留账户、链、挖矿、快照、时间戳、RPC、Gas 和分叉设置。Ganache 最适合被视为旧版 Ethereum 开发基础设施，其测试理念至今仍影响着现代本地区块链工具。