【从0学习Solidity】函数输出（returns）一文读懂

在 Solidity（^0.8.x）里，函数输出本质是按 ABI 编码后返回到调用方。理解“能返回什么”“如何返回”“何时不该返回”，能让合约既清晰又省 gas。下面用最新语法与实践要点带你速通。🚀

一、你能返回什么？

• 值类型：uint256/int256/bool/address/bytes32 等。
• 引用类型：string、bytes、动态/定长数组、struct。
  外部可见函数（public/external）返回这些类型时，数据位置为 memory，由 ABI 复制编码。
• storage 引用：仅限 internal/private 函数可返回 storage 引用（常用于库/内部工具），对外不可。
• 不能返回：mapping、function 类型、复杂的递归结构。
• 自动 getter：public 状态变量自动生成 getter：标量直接返回；动态数组只返回单个索引元素；mapping 只按键查询返回值（不返回全集）。📌

二、返回值的 4 种常见写法

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

contract FnReturns {
    // 1) 单值返回（最清晰）
    function add(uint256 a, uint256 b) external pure returns (uint256) {
        return a + b;
    }

    // 2) 多值 + 命名返回（可读性强，可用“空 return”）
    function stats(uint256[] calldata xs)
        external
        pure
        returns (uint256 min_, uint256 max_, uint256 sum_)
    {
        require(xs.length > 0, "EMPTY");
        min_ = xs[0]; max_ = xs[0];
        for (uint i = 0; i < xs.length; i++) {
            uint v = xs[i];
            if (v < min_) min_ = v;
            if (v > max_) max_ = v;
            sum_ += v;
        }
        // 命名返回变量已被赋值，此处可直接 `return;`
    }

    // 3) 返回 struct / string / bytes（对外一律 memory）
    struct User { uint256 id; string name; }
    mapping(uint256 => User) private users;
    function getUser(uint256 id) external view returns (User memory) {
        User storage s = users[id];
        require(bytes(s.name).length != 0, "NOT_FOUND");
        return s; // 自动从 storage 复制到 memory 再 ABI 编码
    }

    // 4) internal 返回 storage 引用（仅内部使用）
    function _userRef(uint256 id) internal view returns (User storage u) {
        u = users[id];
    }
}
​

要点：

• 命名返回变量并不会“天然省 gas”，只是可读性与空 return 更方便。
• 对外返回大型动态数组/字符串，会产生高拷贝与编码成本，并受返回数据大小限制；数据量大时更推荐事件（event）、分页、或仅返回校验哈希。⚠️

三、调用端的“解构赋值”

pragma solidity ^0.8.25;

interface I {
    function stats(uint256[] calldata xs)
        external view returns (uint256 min_, uint256 max_, uint256 sum_);
}

contract Use {
    function demo(I t, uint256[] calldata xs) external view returns (uint256, uint256) {
        (uint256 lo, , uint256 total) = t.stats(xs); // 跳位解构：忽略 max_
        return (lo, total);
    }
}
​

• 可以按位置解构，用逗号占位忽略不需要的返回值。
• 注意返回顺序与类型严格匹配。

四、view/pure/payable 与输出

• view/pure 仅限制读写状态，不限制返回；返回的值仍走 ABI 编码。
• payable 与返回并不冲突：函数既可接收 ETH 又可返回值。
• receive() / fallback() 一般用于接收 ETH 或兜底分发，不应设计依赖返回值的交互（外部调用通常不会消费其返回数据）；如需表达结果，用事件或显式状态变更。💡

五、错误处理 vs 返回值

• 当出现非法输入/状态时，优先使用 require / revert / 自定义错误（error E(xxx)），不要返回“错误码”让调用方自行判断。
  自定义错误更省 gas，信息更清晰。

六、常见坑与规避

1. 返回引用类型忘记数据位置：对外返回 struct/bytes/string/数组 时由编译器自动用 memory，无需手填 memory；但在内部临时变量上仍需规范标注，避免多余拷贝。
2. 大数组直传直返：易超出返回大小限制并浪费 gas。改为分页查询、事件日志或仅返回摘要。
3. 滥用命名返回：命名返回变量若未完整赋值就 return; 会产生未期望的默认值。建议在复杂分支里显式 return (a,b,...)。
4. 试图返回 mapping：不被支持；改设计为按键查询或事件导出。

七、原理解释表（精炼版）

上一篇：【Solidity】引用类型, array, struct

下一篇：【从0学习Solidity】映射类型mapping