智能合约与以太坊 / 系统课时

辨别三种数据位置的作用

辨别三种数据位置的作用

在 Solidity 中,同样是修改结构体字段,结果可能写入链上,也可能只改变临时副本。区别取决于数据位于 storage、memory 还是 calldata。本课通过一份可直接部署的合约,观察引用、复制与只读参数的行为,并掌握选择数据位置的方法。

学习目标

  • 区分 storage、memory、calldata 的生命周期、可修改性与适用场景。
  • 通过结构体和动态数组实验,验证引用与复制对持久化状态的影响。
  • 识别常见的数据位置误用,并根据读写需求选择合适的声明方式。

三种数据位置分别保存什么

Solidity 的结构体、数组等引用类型需要明确数据位置。数据位置决定数据保存在哪里,以及赋值操作建立引用还是创建副本。下面的规则适用于 Solidity 0.8.20 及兼容的 0.8.x 版本。

数据位置 生命周期 是否可修改 典型用途
storage 状态数据随合约持久存在 可以,受函数权限和执行规则约束 合约状态变量、状态引用
memory 当前调用执行期间 可以 临时计算、结构体副本、函数返回数据
calldata 当前外部调用期间 不可以 外部传入的数组、结构体和字节数据

状态变量默认位于 storage,其更新在交易成功执行后成为链上状态的一部分。函数中的局部 storage 引用不会单独创建一份持久化数据,而是指向已有的存储对象。

memory 保存临时数据。从 storage 赋值到 memory 会创建独立副本,修改副本不会自动回写。calldata 则是只读的调用输入区域,适合不需要修改参数的函数。

storage、memory 和 calldata 的数据流及引用复制关系

需要注意,数据位置与变量作用域不是同一个概念。局部 storage 引用只在函数执行期间有效,但它修改的持久化状态可以跨交易保留;memory 临时变量即使被修改,也不会因为函数成功结束而自动写入链上。

用结构体验证引用与复制

下面定义一个 Record 结构体,包含分数 score 和动态数组 marks。初始分数为 10,数组第一个元素为 1。合约分别使用 storage 引用和 memory 副本修改这两个字段,并提供 calldata 只读计算函数。

在 Remix 中创建 LocationExperiment.sol,粘贴完整代码,选择符合 ^0.8.20 的 Solidity 编译器,然后在 Deploy & Run Transactions 面板使用 Remix VM 部署。

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

contract LocationExperiment {
    struct Record {
        uint256 score;
        uint256[] marks;
    }

    Record private record;

    constructor() {
        record.score = 10;
        record.marks.push(1);
    }

    function editStorage() external {
        // 局部 storage 变量引用原始状态
        Record storage linked = record;
        linked.score += 5;
        linked.marks[0] = 7;
    }

    function previewMemory()
        external
        view
        returns (uint256, uint256)
    {
        // 复制结构体及其动态数组到 memory
        Record memory copied = record;
        copied.score += 100;
        copied.marks[0] = 9;
        return (copied.score, copied.marks[0]);
    }

    function memoryAlias() external pure returns (uint256) {
        uint256[] memory a = new uint256[](1);
        a[0] = 3;
        uint256[] memory b = a;
        // memory 到 memory 的赋值共享数组引用
        b[0] = 8;
        return a[0];
    }

    function sumCalldata(uint256[] calldata values)
        external
        pure
        returns (uint256 result)
    {
        for (uint256 i = 0; i < values.length; i++) {
            result += values[i];
        }
    }

    function readState()
        external
        view
        returns (uint256, uint256)
    {
        return (record.score, record.marks[0]);
    }
}

预期结果:合约编译成功且能够部署。首次调用 readState() 返回 (10, 1),表示构造函数已经初始化持久化状态。previewMemory() 虽然修改了临时副本,但由于声明为 view,不会修改链上状态。

这里有两个不同的赋值规则:Record storage linked = record 只创建引用;Record memory copied = record 则复制结构体内容,包括其中的动态数组。因此修改 copied.marks[0] 不会影响 record.marks[0]。

按顺序调用并核对状态

在 Remix 已部署合约的操作区域,按照下面的顺序调用函数。每一步都使用同一个合约实例,避免重新部署导致状态重置。

调用顺序 函数与参数 预期结果
1 readState() 返回 (10, 1)
2 previewMemory() 返回 (110, 9)
3 readState() 仍返回 (10, 1)
4 memoryAlias() 返回 8
5 sumCalldata([2,3,4]) 返回 9
6 editStorage() 交易成功执行
7 readState() 返回 (15, 7)

观察第二步和第三步:临时副本的 score 从 10 变为 110,数组元素从 1 变为 9,但原始状态完全没有变化。这说明 storage 到 memory 的赋值创建了独立数据。

第四步展示另一个容易混淆的情况。两个 memory 动态数组变量通过直接赋值共享同一数组引用,所以修改 b[0] 后,读取 a[0] 得到 8。不能认为所有涉及 memory 的赋值都会深拷贝。

第六步执行的是状态修改交易。linked 引用原始结构体,linked.score += 5 和 linked.marks[0] = 7 直接修改持久化状态。交易成功后,第七步能读到新值;如果交易发生回滚,状态修改则不会保留。

sumCalldata([2,3,4]) 只读取输入数组并计算总和 9,不复制到 memory,也不写入 storage。如果尝试在函数中执行 values[0] = 99,编译器会拒绝,因为 calldata 不允许修改。

判断赋值是否会影响链上状态

以下规则适用于结构体、数组等引用类型,不能机械套用到 uint256、bool 等值类型。

赋值关系 实际行为 修改后的影响
storage → 局部 storage 引用同一存储对象 修改会影响原状态
storage → memory 创建独立副本 修改副本不影响原状态
memory → memory 通常共享引用 修改数组或结构体成员可被另一变量观察到
calldata → memory 创建独立副本 可以修改副本,原始输入不变
memory → 状态变量 storage 复制数据到存储 成功交易中更新持久化状态

例如,Record memory copied = record 后修改 copied.score,并不会自动保存。若确实要将整个副本写回,可以执行 record = copied,但这会复制结构体及其数组数据到持久化存储,可能产生较高的 Gas 消耗。

还要区分局部引用与存储分配。Record storage linked = record 的前提是已经存在可引用的存储对象;不能将局部 storage 变量当作 memory 那样随意创建新的结构体实例。

根据实际读写需求选择位置

可以按数据最终是否需要持久化来决定声明方式。

  • 需要修改链上状态:使用状态变量或局部 storage 引用。例如修改用户积分、库存或订单状态。写入会消耗 Gas,必须考虑权限和交易回滚。
  • 需要临时加工数据:使用 memory。例如读取链上结构体,修改副本后计算返回值,或者构建临时数组。注意从 storage 复制大型对象可能增加执行成本。
  • 只需要读取外部输入:优先考虑 calldata。例如接收一组交易 ID、地址或金额并遍历校验,通常能够避免不必要的初始内存复制。

对于一个包含 100 个元素的数组,如果外部函数只需要遍历求和,uint256[] calldata values 是合适的选择。如果需要排序或原地改写数组元素,应先复制到 memory;如果排序结果必须跨交易保留,则需要明确写入 storage。

实际开发中,可以用三个问题检查数据位置:数据是否必须跨调用保存、当前操作是否需要修改原始对象、赋值之后两个变量是否应该共享变化。结合本课实验,只有成功执行的持久化写入才改变链上状态;临时副本和只读调用输入不会自动产生持久化效果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

辨别三种数据位置的作用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通