首页
学习
活动
专区
圈层
工具
发布
49 篇文章
1
《纸上谈兵·solidity》第 0 课:搭建 Solidity 开发环境(三种方式)
2
《纸上谈兵·solidity》第 1 课:部署你的第一个 Solidity 合约
3
《纸上谈兵·solidity》第 2 课:调用、修改、读取,Solidity 合约不是 REST API
4
《纸上谈兵·solidity》第 3 课:事件(Event)机制与链上日志——不是 print,是广播!
5
《纸上谈兵·solidity》第 4 课:Solidity 合约中的错误处理机制(`require`、`revert`、`assert`)和自定义错误
6
《纸上谈兵·solidity》第 5 课:依赖与外部调用 —— 合约交互的风险与防护
7
《纸上谈兵·solidity》第 6 课:Solidity 数据存储布局 —— memory、storage、calldata 傻傻分不清?
8
《纸上谈兵·solidity》第 7 课:Solidity 函数可见性和修饰器 —— public 和 private 不只是权限标签
9
《纸上谈兵·solidity》第 8 课:Solidity 中的继承与接口 —— 模块化不是“复制粘贴”的借口
10
《纸上谈兵·solidity》第 9 课:Solidity 事件与日志机制 —— 合约世界的“printf”工具
11
《纸上谈兵·solidity》第 10 课:Solidity `fallback` / `receive` 函数 —— 合约如何收 ETH 和响应未知调用?
12
《纸上谈兵·solidity》第 11 课:Solidity 错误处理与异常机制 —— 让合约优雅地失败
13
《纸上谈兵·solidity》第 12 课:Solidity 函数选择器与 ABI 编码原理
14
《纸上谈兵·solidity》第 13 课:Solidity 低级调用 call/delegatecall/staticcall —— 直接和 EVM“对话”
15
《纸上谈兵·solidity》第 14 课:Solidity 中的可升级合约模式 —— 从代理合约到透明代理、UUPS 与安全陷阱
16
《纸上谈兵·solidity》第 15 课:Solidity 库与可重用代码
17
《纸上谈兵·solidity》第 16 课:Pull over Push 支付模式与 Check-Effects-Interactions 原则
18
《纸上谈兵·solidity》第 17 课:合约设计模式实战(二)—— Access Control 与权限管理
19
《纸上谈兵·solidity》第 18 课:合约设计模式实战(三)—— 代理 + 插件化架构(Diamond Standard / EIP-2535)
20
《纸上谈兵·solidity》第 19 课:安全专题(一)—— 常见攻击手法与防御
21
《纸上谈兵·solidity》第 20 课:Solidity 安全专题(二)—— 编译器特性与低级漏洞
22
《纸上谈兵·solidity》第 21 课:Gas 优化与成本分析 —— 写出便宜的智能合约
23
《纸上谈兵·solidity》第 22 课:代币合约(ERC20)从零实现与扩展
24
《纸上谈兵·solidity》第 23 课:NFT 合约(ERC721 / ERC1155)实战
25
《纸上谈兵·solidity》第 24 课:去中心化众筹合约(Crowdfunding)实战
26
《纸上谈兵·solidity》第 25 课:简化版的去中心化交易所(DEX)简化版
27
《纸上谈兵·solidity》第 26 课:借贷合约简化实现
28
《纸上谈兵·solidity》第 27 课:DAO 治理合约(去中心化自治组织)
29
《纸上谈兵·solidity》第 28 课:智能合约安全审计案例复盘 -- The DAO Hack(2016)
30
《纸上谈兵·solidity》第 29 课:智能合约安全审计案例复盘 -- Parity Wallet Hack(2017)
31
《纸上谈兵·solidity》第 30 课:智能合约安全审计案例复盘 -- Nomad Bridge(2022)
32
《纸上谈兵·solidity》第 31 课:多签钱包在跨链桥中的应用 —— Nomad 事件复盘
33
《纸上谈兵·solidity》第 32 课:DeFi 基础合约
34
《纸上谈兵·solidity》第 33 课:多签钱包(Multisig Wallet)-- 合约设计与实现
35
《纸上谈兵·solidity》第 34 课:多签钱包(Multisig Wallet)-- 上线
36
《纸上谈兵·solidity》第 35 课:去中心化交易所(DEX)实战 — 合约设计
37
《纸上谈兵·solidity》第 36 课:去中心化交易所(DEX)实战 — 上线
38
《纸上谈兵·solidity》第 37 课:DeFi 实战 -- 资金池与利率模型
39
《纸上谈兵·solidity》第 38 课:DeFi 实战(2) -- 清算机制与价格预言机
40
《纸上谈兵·solidity》第 39 课:DeFi 实战(3) -- 利息累积与 aToken 设计
41
《纸上谈兵·solidity》第 40 课:DeFi 实战(4) -- 风险控制与防护
42
《纸上谈兵·solidity》第 41 课:DeFi 实战(5) -- 协议费与治理
43
《纸上谈兵·solidity》第 42 课:DeFi 实战(6) -- 跨资产借贷与多市场支持
44
《纸上谈兵·solidity》第 43 课:DeFi 实战(7) -- 清算机制进阶(多资产抵押清算路径、拍卖机制)
45
《纸上谈兵·solidity》第 44 课:DeFi 实战(8) -- 利率曲线与资金池优化(动态利用率模型)
46
《纸上谈兵·solidity》第 45 课:DeFi 实战(9) -- 利息累积与结算机制(可复利)
47
《纸上谈兵·solidity》第 46 课:DeFi 实战(10) -- 跨链借贷与流动性桥接
48
《纸上谈兵·solidity》第 47 课:DeFi 实战(11) -- 治理代币 & 激励机制(Tokenomics & Governance)
49
《纸上谈兵·solidity》第 48 课:DeFi 实战(12) -- 前端 DApp 集成与用户交互(React + ethers.js 实战)

《纸上谈兵·solidity》第 6 课:Solidity 数据存储布局 —— memory、storage、calldata 傻傻分不清?

在 Solidity 编程中,变量的“声明”远远不只是类型和名字,更关键的是 —— 存储位置(data location)。错误使用 memorystoragecalldata 不仅影响正确性,更直接影响 gas 成本、安全性和语义一致性

本课将深入讲解三种关键存储类型,并通过 Foundry 实例演示数据的读写、传递与修改行为。


一、三大存储位置概述

存储位置

生命周期

读写权限

读/写成本

应用场景

storage

合约永久状态变量

可读可写

读/写都昂贵

状态变量、长期持久化存储

memory

函数调用期间有效

可读可写

便宜(RAM式)

局部变量、中间临时处理

calldata

函数外部调用参数只读

只读

极便宜

external 函数的参数(特别适合数组)


二、状态变量(storage)

  • 所有 state variable 都自动存储在 storage 中。
  • 是 Solidity 最昂贵的存储类型,因为它对应 EVM 中的持久化状态存储(State Trie)。
代码语言:txt
复制
contract Example {
    uint[] public values; // 默认在 storage 中

    function update() public {
        values.push(1); // 直接修改 storage
    }
}
  • 可以通过 storage 引用函数参数或局部变量,但此时是指针引用
代码语言:txt
复制
function modify(uint[] storage arr) internal {
    arr[0] = 42; // 直接修改原始数组
}

三、memory 临时数据区

  • 用于函数中的临时变量和参数拷贝。
  • 生命周期仅在函数调用期间。
  • 在调用时创建,在返回时销毁。
  • 写入和读取比 storage 更便宜,但数据不会持久。
代码语言:txt
复制
function copy(uint[] memory data) public pure returns (uint) {
    data[0] = 123; // 修改的是 memory 中的副本
    return data[0];
}

使用 memory 时,变量是“值传递”或“拷贝引用”,不会影响 storage 中原始数据。


四、实验:storage vs memory 修改对比

代码语言:txt
复制
contract DataTest {
    uint[] public data;

    constructor() {
        data.push(1);
        data.push(2);
        data.push(3);
    }

    // 修改副本(不改变原始 storage)
    function updateMemory() public view returns (uint[] memory) {
        uint[] memory temp = data;
        temp[0] = 99;
        return temp; // 原始 data 不变
    }

    // 修改 storage 变量本身
    function updateStorage() public {
        uint[] storage temp = data;
        temp[0] = 88;
    }
}

Foundry 测试用例

代码语言:txt
复制
contract StorageTest is Test {
    DataTest dt;

    function setUp() public {
        dt = new DataTest();
    }

    function testUpdateMemoryDoesNotAffectStorage() public {
        uint[] memory result = dt.updateMemory();
        assertEq(result[0], 99);                // 复制体被改
        assertEq(dt.data(0), 1);                // storage 未改
    }

    function testUpdateStorageAffectsState() public {
        dt.updateStorage();
        assertEq(dt.data(0), 88);               // 状态变量被改变
    }
}

五、calldata 外部调用参数(只读)

  • 函数参数在 external 函数中默认使用 calldata
  • 它是最便宜的内存类型。
  • 只读,不可修改。
  • 通常用于接收大量数组或字符串的函数。
代码语言:txt
复制
function readOnly(uint[] calldata data) external pure returns (uint) {
    // 编译失败
    data[0] = 10;
    return data[0]; // 不能修改 data
}

当你写 external 函数且带有数组参数时,推荐使用 calldata

代码语言:txt
复制
function sum(uint[] calldata nums) external pure returns (uint) {
    return nums[0] + nums[1];
}

优势:

  • 不能修改,更安全
  • gas 成本更低(比 memory 少一次复制)

不支持写入或 push/pop:

代码语言:txt
复制
// 编译失败
function fail(uint[] calldata nums) external {
    nums[0] = 1; // 不能修改 calldata
}

六、测试演示(Foundry 示例)

src/DataLocation.sol:

代码语言:txt
复制
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract DataLocation {
    uint[] public store;

    function storeToMemory() public view returns (uint[] memory) {
        uint[] memory temp = new uint[](store.length);
        for (uint i = 0; i < store.length; i++) {
            temp[i] = store[i];
        }
        return temp;
    }

    function storeFromCalldata(uint[] calldata input) external {
        store = input; // 拷贝 calldata 到 storage
    }

    function getCalldata(uint[] calldata input) external pure returns (uint) {
        return input[0]; // 只能读,不能写
    }
}

test/DataLocation.t.sol:

代码语言:txt
复制
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "forge-std/Test.sol";
import "../src/DataLocation.sol";

contract DataLocationTest is Test {
    DataLocation dl;

    function setUp() public {
        dl = new DataLocation();
    }

    function testMemoryCopy() public {
        uint[] memory input;
        input = new uint[](1);
        input[0] = 10;

        dl.storeFromCalldata(input);

        uint[] memory result = dl.storeToMemory();
        assertEq(result[0], 10);
    }

    function testGetCalldata() public view {
        uint[] memory arr;
        arr = new uint[](1);
        arr[0] = 42;

        uint val = dl.getCalldata(arr); 
        assertEq(val, 42);
    }
}

执行结果:

代码语言:bash
复制
$ ➜  counter git:(main) ✗ forge test --match-path test/DataLocation.t.sol  -vvv
[⠊] Compiling...
[⠒] Compiling 1 files with Solc 0.8.30
[⠑] Solc 0.8.30 finished in 535.07ms
Compiler run successful!

Ran 2 tests for test/DataLocation.t.sol:DataLocationTest
[PASS] testGetCalldata() (gas: 10033)
[PASS] testMemoryCopy() (gas: 57458)
Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 4.60ms (2.16ms CPU time)

Ran 1 test suite in 182.96ms (4.60ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests)

七、小结对比

特性

storage

memory

calldata

生命周期

永久存储

函数调用期间

函数调用期间

可修改性

gas 成本

使用场景

状态变量

临时变量

外部参数传入


八、建议实践

  • 函数参数能用 calldata 就用 calldata,尤其是 external 函数,能节省大量 Gas。
  • 避免误用 storage 引用,会导致原始状态被意外修改。
  • 了解深浅拷贝行为,能避免修改副本却期望原始数据变化的误解。

小练习

  1. 实现一个函数,接受 calldata 数组,复制到 memory 并排序。
  2. 编写 storage 引用和 memory 副本操作对比函数,配合 Foundry 测试验证行为。
  3. 编写一个结构体数组操作合约,理解不同位置之间的行为差异。

下一课导读

《第 7 课:Solidity 函数可见性和修饰器 —— public 和 private 不只是权限标签》

下一篇
举报
领券