# @ganache/console\.log 中文文档

规范地址：https://npmcn.com/package/%40ganache/console.log/

版本：0\.4\.2
npm 元数据更新时间：2023-12-21T00:19:59.720Z
中文译文更新时间：2026-11-15T22:28:02.280Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ganache/console.log
原文对照：https://npmcn.com/package/%40ganache/console.log/?lang=original
项目主页：https://github.com/trufflesuite/ganache/tree/develop/packages/ethereum/console.log#readme
源码仓库：https://github.com/trufflesuite/ganache

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：315 kB，29 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2022-07-20T15:15:48.830Z
- 最新版本发布：2023-12-21T00:19:59.509Z
- 近 30 天下载量：6772（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 0 个）

## 中文简介

用于使用来自 Soliity 合同的 Control.log 的固件库和 EVM 钩

## 安装

```sh
npm install @ganache/console.log
```

也可以使用：`pnpm add @ganache/console.log`、`yarn add @ganache/console.log`、`bun add @ganache/console.log`

## README

# `@ganache/console.log`

团结库和用于使用的 EVM 钩 `console.log` 从团结 合同.

## 用法 :

`@ganache/console.log` 设计用于与 [`@ethereumjs/vm` 无 软件包](https://www.npmjs.com/package/@ethereumjs/vm)。 。 。 .

安装 `@ganache/console.log`数字 :

```console
> npm install @ganache/console.log --save-exact
```

`@ganache/console.log` 有两个部分,a `console.sol` 团结库文件,以及 用于获取通过使用该程序生成的日志的方法 `console.sol` 图书馆.

### `console.sol` 团结图书馆

这个 `console.sol` 库可在 `@ganache/console.log/console.sol`。 。 。 . 有多种方式可以向您的合同和合同提供这个档案 固态会建立管线,所以这部分留给用户来决定.

像其他图书馆一样在团结中使用,例如,

```solidity
// SPDX-License-Identifier: MIT
pragma solidity >= 0.4.22 <0.9.0;

import "console.sol";

contract MyContract {
    constructor() {
        console.log("got here");
    }
}
```

### `console.log` 解析器( a)`maybeGetLogs`:

用于 `@ganache/console.log` 直接发生在 `@ethereumjs/vm` 视频:

```typescript
import { ConsoleLogs, maybeGetLogs } from "@ganache/console.log";

// ... initialize vm ...

// vm should be an instance of @ethereumjs/vm
vm.evm.events.on("step", event => {
  const logs: ConsoleLogs | null = maybeGetLogs(event); // (string | bigint | boolean)[] | null
  // do something with `logs`
});
```

注:Ganache CLI,以及 `Ganache.server` 财务报告和审定财务报表 `Ganache.provider`已经 执行日志解析器,并将自动日志调用到 `console.sol` 改为 与 JavaScript 相同的标准输出 `console.log`。 。 。 .

## 常见问题

### @ganache/console\.log 是什么？

用于使用来自 Soliity 合同的 Control\.log 的固件库和 EVM 钩

### 如何安装 @ganache/console\.log？

在项目目录运行 npm install @ganache/console\.log，或使用 pnpm add / yarn add / bun add。

### @ganache/console\.log 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @ganache/console\.log 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @ganache/console\.log 可以商用吗？

@ganache/console\.log 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ganache/console\.log 的下载量有多少？

根据 npm 官方下载统计，@ganache/console\.log 在 2026/10/16 – 2026/11/14 这 30 天内被下载 6,772 次，日均约 226 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ganache/console\.log 还在维护吗？

最新版本 0\.4\.2 发布于 2023/12/21（2 年前）；至今共发布 7 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/07/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。