Solidity 合约调用合约：从入门到精通的实战手册

核心关键词：合约调用、内部合约、外部合约、Solidity 高级写法、安全性、gas 优化、多次调用、委托调用

Solidity 并不仅限于单个合约的「独角戏」。任何生产级项目都会涉及「合约调用合约」：内部合约在同一文件内直接交互，外部合约跨越文件与链上边界；更上一层，开发者可以用接口、低层级 call、MultiCall 与 MultiDelegateCall 实现批量交互、可升级逻辑乃至节省 sky-high 的 gas。本文拆成 4 大场景，配源码、测试与 FAQ，帮助你在下一行代码里写出优雅而安全的跨合约通信。

场景一：调用内部合约（同文件下的 freemint）

在单个 .sol 文件里，合约编译完后地址与名字就已确定。此时有两种最常见的写法：

方法 1：显式类型转换

把 address 转成指定合约对象，再调函数：

Test(_ads).setX(_x);
// 或
Test temp = Test(_ads);
temp.setX(_x);

方法 2：直接参数声明

直接把参数声明为合约类型，代码更简洁、gas 略低：

function setX2(Test _ads, uint256 _x) public {
    _ads.setX(_x);
}

Gas 对比：测试显示方法 1 约 22,9647 单位 gas，方法 2 跌落到 27,923。两者都在可接受范围，选择哪种取决于 可读性 与 复用性。

附：同时转账

调用函数并发送 ETH 的语法是：

Test(_ads).setYBySendEth{value: msg.value}();

点击查看源码示例

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.18;

contract Test {
    uint256 public x = 1;
    uint256 public y = 2;

    function setX(uint256 _x) public        { x = _x; }
    function getX() public view returns (uint256) { return x; }
    function setYBySendEth() public payable { y = msg.value; }
    function getXandY() public view returns (uint256, uint256) {
        return (x, y);
    }
}

contract CallTest {
    // 方法 1：转换地址
    function setX1(address _ads, uint256 _x) public {
        Test(_ads).setX(_x);
    }
    // 方法 2：直接传合约
    function setX2(Test _ads, uint256 _x) public {
        _ads.setX(_x);
    }
}

场景二：调用外部合约 —— 接口 vs 签名

当合约身处不同文件或已被部署时，开发者需通过「桥」连接。常见两座桥：接口与 低层级签名调用。

1. 接口调用（推荐）

优点：静态类型安全；IDE 自动补全；gas 更低。
写法：

interface AnimalEat {
    function eat() external returns (string memory);
}

contract Animal {
    function test(address _addr) external returns (string memory) {
        return AnimalEat(_addr).eat();
    }
}

2. 低层级签名调用

三种工具：call、delegatecall、staticcall。

call：最常用，能做「函数调用 + 转账」。
delegatecall：逻辑运行在当前合约存储，适合代理升级，但要绝对保证 layout 一致。
staticcall：只读调用，函数一旦改状态就回滚。

以 call 为例：

bytes memory payload = abi.encodeWithSignature(
    "setNameAndAge(string,uint256)",
    _name,
    _age
);
(bool success, bytes memory response) = _ads.call{value: msg.value}(payload);
require(success, "Call Failed");

👉 一文看懂 delegatecall 升级陷阱：从 Parity 钱包事故中学会的 5 个教训

场景三：MultiCall 与批量节省 gas

链上 RPC 有调用上限？或者前端一次想读 20 个 getter？MultiCall 允许一次性把 N 个外部调用打到链上。

核心实现

targets[]：目标合约地址
data[]：已编码的函数签名
每个调用返回 bytes 结果数组

function multiCall(
    address[] calldata targets,
    bytes[] calldata data
) external view returns (bytes[] memory) {
    require(targets.length == data.length, "length mismatch");
    bytes[] memory results = new bytes[](data.length);
    for (uint256 i = 0; i < targets.length; i++) {
        (bool s, bytes memory r) = targets[i].staticcall(data[i]);
        require(s, "call failed");
        results[i] = r;
    }
    return results;
}

限制：被调用合约看见的 msg.sender 是 MultiCall 本身，而非最终用户。如果涉及权限校验需留意。

场景四：MultiDelegateCall —— 让用户声音直达函数

当业务要求被调用合约识别真实用户地址（如权限 NFT 检查），delegatecall 成为解决思路：逻辑在本合约执行，但上下文保留用户身份。升级方式同 UniV3-style 代理。

实现套路与 MultiCall 相似，不过需警惕 余额重复累加 等类似「闪电贷漏洞」。核心代码：

function multiDelegatecall(bytes[] calldata data) external returns (bytes[] memory) {
    bytes[] memory results = new bytes[](data.length);
    for (uint256 i = 0; i < data.length; i++) {
        (bool s, bytes memory r) = address(this).delegatecall(data[i]);
        require(s, "delegatecall failed");
        results[i] = r;
    }
    return results;
}

👉 如何 3 分钟写出零 gas 的 NFT Claim？附 Demo 仓库

常见问题与解答（FAQ）

Q1：内部合约和外部合约 gas 差异大吗？
A：在主网层级差异仅几百 gas，优化焦点应放在「批量调用」与「避免无效存储操作」。

Q2：何时必须用 delegatecall？
A：你打算做 可升级代理 或链路其他合约逻辑却要求 msg.sender 保持最终用户地址时。

Q3：怎样防住 call 的重入攻击？
A：遵循 Checks-Effects-Interactions；在每次外部调用前更新状态；或使用 ReentrancyGuard。

Q4：staticcall 会不会不兼容已有的 read 函数？
A：只要函数确实没改状态，就不会有问题；检查函数 purity/payable 修饰即可。

Q5：MultiCall 会一次性爆 block gas limit 吗？
A：有可能。建议 单次 < 800w gas；前端分页或链下缓存缓存结果。

Q6：delegatecall 升级时字段顺序写错会怎样？
A：存储插槽错乱，轻则读取错位数据，重则直接 brick 合约。永远用 自动化测试 + 插槽规范文档。

结语

掌握「合约调用合约」不是炫技，而是通往 DeFi、NFTFi、GameFi 应用的必经之路。
把本文代码复制到 Remix，跳过 仓库配置、测试脚本 直接在 IDE 运行，三分钟就能复现今天讲的一切。祝你写出更低 gas、更安全、也更优雅的 Solidity 逻辑。