智能合约与以太坊 / 系统课时
辨别三种数据位置的作用
辨别三种数据位置的作用
在 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 临时变量即使被修改,也不会因为函数成功结束而自动写入链上。
用结构体验证引用与复制
下面定义一个 Record 结构体,包含分数 score 和动态数组 marks。初始分数为 10,数组第一个元素为 1。合约分别使用 storage 引用和 memory 副本修改这两个字段,并提供 calldata 只读计算函数。
在 Remix 中创建 LocationExperiment.sol,粘贴完整代码,选择符合 ^0.8.20 的 Solidity 编译器,然后在 Deploy & Run Transactions 面板使用 Remix VM 部署。
// 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。
实际开发中,可以用三个问题检查数据位置:数据是否必须跨调用保存、当前操作是否需要修改原始对象、赋值之后两个变量是否应该共享变化。结合本课实验,只有成功执行的持久化写入才改变链上状态;临时副本和只读调用输入不会自动产生持久化效果。