Remix IDE运行Solidity代码无报错，VS Code安装扩展后报错

问题重现 #

以下合约代码在Remix IDE中编译运行无错误，但在VS Code安装Solidity官方扩展后出现编译报错：

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.7;

contract Transactions {
    uint256 transactionCount;

    event Transfer(address from, address receiver, uint amount, string message, uint256 timestamp, string keyword);
  
    struct TransferStruct {
        address sender;
        address receiver;
        uint amount;
        string message;
        uint256 timestamp;
        string keyword;
    }

    TransferStruct[] transactions;

    function addToBlockchain(address payable receiver, uint amount, string memory message, string memory keyword) public {
        transactionCount += 1;
        transactions.push(TransferStruct(msg.sender, receiver, amount, message, block.timestamp, keyword));

        emit Transfer(msg.sender, receiver, amount, message, block.timestamp, keyword);
    }

    function getAllTransactions() public view returns (TransferStruct[] memory) {
        return transactions;
    }

    function getTransactionCount() public view returns (uint256) {
        return transactionCount;
    }
}

常见原因及解决步骤 #

1. 编译器版本不匹配 #

VS Code的Solidity扩展默认使用的编译器版本可能不在^0.8.7的兼容范围内，导致编译报错。

解决方法：

• 打开VS Code设置（快捷键Ctrl+,或Cmd+,）
• 搜索Solidity: Compile Using Remote Version
• 选择符合^0.8.7的版本，比如v0.8.7、v0.8.20等兼容版本
• 也可以在项目根目录创建hardhat.config.js（若使用Hardhat），指定编译器版本：

  module.exports = {
    solidity: "0.8.7",
  };
  

2. 扩展配置冲突 #

若项目中有Hardhat/Truffle的配置文件，扩展会优先读取这些配置，若配置中的版本与合约声明的^0.8.7不匹配，会引发错误。

解决方法：

• 检查项目根目录的hardhat.config.js或truffle-config.js，确保solidity字段设置为^0.8.7或兼容版本
• 若不需要这些工具，可暂时移除配置文件，或在VS Code设置中关闭Solidity: Enable Hardhat Support，强制扩展使用单独的编译器配置

3. 扩展缓存问题 #

扩展留存的旧编译缓存可能导致异常报错。

解决方法：

• 打开VS Code命令面板（快捷键Ctrl+Shift+P或Cmd+Shift+P）
• 输入Solidity: Clear Compiler Cache并执行
• 重新编译合约（命令面板输入Solidity: Compile All Contracts）

4. 工作区设置覆盖 #

项目的本地工作区配置可能覆盖了全局Solidity扩展设置，导致版本不兼容。

解决方法：

• 打开项目目录下的.vscode/settings.json文件
• 检查是否存在solidity.compileUsingRemoteVersion或solidity.localCompilerPath字段，确保其值符合^0.8.7的版本要求
• 若配置错误，直接修改或删除对应字段即可

内容的提问来源于stack exchange，提问作者Anupam kumar