Truffle测试智能合约代码覆盖率：Windows报错解决及替代方案

一、解决truffle-plugin.json not found报错的步骤 #

1. 版本兼容性检查 #

solidity-coverage 0.7.x系列仅兼容Truffle 5.x版本，先执行truffle version确认你的Truffle版本：

• 如果Truffle版本低于5.x，升级Truffle：npm install -g truffle@latest
• 如果Truffle版本高于5.5.x，建议安装solidity-coverage 0.7.22+版本（修复了部分兼容性问题）

2. 重新安装依赖并清理缓存 #

执行以下命令彻底重装：

npm uninstall solidity-coverage
npm cache clean --force
npm install solidity-coverage@0.7.22 --save-dev

3. 确认Truffle配置 #

打开truffle-config.js，确保plugins数组中包含solidity-coverage：

module.exports = {
  networks: { /* 你的网络配置 */ },
  plugins: ["solidity-coverage"], // 必须添加这一行
  compilers: { /* 编译器配置 */ }
};

4. Windows环境特殊处理 #

• 用管理员权限打开命令提示符或PowerShell，避免文件权限问题导致安装不完整
• 如果使用PowerShell，执行Set-ExecutionPolicy RemoteSigned（按提示输入Y确认），允许执行脚本

二、替代覆盖率工具方案 #

1. Hardhat + hardhat-coverage（推荐） #

Hardhat的覆盖率工具兼容性更好，步骤如下：

• 安装Hardhat：npm install hardhat --save-dev
• 初始化项目：npx hardhat（可选择创建空项目或导入现有Truffle项目）
• 安装插件：npm install hardhat-coverage --save-dev
• 运行覆盖率检测：npx hardhat coverage
• 执行完成后会在项目根目录生成coverage文件夹，包含HTML格式的详细覆盖率报告

2. Ganache + Istanbul（手动方案） #

适合无法切换框架的场景，但配置较繁琐：

• 启动Ganache本地节点：ganache-cli
• 修改Truffle配置，将测试网络指向Ganache
• 运行测试用例并收集执行数据，再用Istanbul工具分析合约编译后的字节码生成覆盖率报告（需手动映射合约源码与字节码，不推荐新手使用）

内容的提问来源于stack exchange，提问作者Roshinie Jayasundara