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

为状态变量选择合适类型

为状态变量选择合适类型

为 Solidity 合约选类型时,要同时核对数值上限、数据含义和默认值。本课用一个可部署的示例比较整数、布尔、地址、字节与字符串,随后在 Remix 中验证状态读取、赋值和溢出回滚,避免把链上存储当成可无限增长的普通变量。

学习目标

  • 根据整数范围和业务含义选择 uint、int、bool、address、bytes 与 string。
  • 判断未初始化状态变量的读取结果,并区分固定长度字节和动态数据。
  • 在 Solidity 0.8.x 中复现整数溢出导致的交易回滚。

按范围选择整数类型

Solidity 的 uint 是 uint256 的别名,int 是 int256 的别名;位宽从 8 到 256,以 8 位递增。只有可能出现负数时才使用有符号整数,计数、余额和发行量通常使用无符号整数。

类型 取值范围 适合保存
uint8 0~255 等级、百分比档位
uint256 0~2256−12^{256}-1 代币数量、累计计数
int16 -32768~32767 有正负方向的调整量
int256 −2255-2^{255}~2255−12^{255}-1 大范围有符号计算

例如等级最大值为 200,uint8 足够;若计数可能超过 255,就不能继续使用 uint8。Solidity 0.8.x 默认检查算术越界:uint8 中的 255 加 1 会回滚,不会自动得到 256。unchecked 可以关闭特定代码块的算术检查,普通业务计数不应随意使用。

区分标志、账户和字节文本

以下是状态变量未显式赋值时的默认值。状态变量不会因为尚未赋值就显示 null。

类型 默认值 使用场景
bool false 是否启用
address 0x0000000000000000000000000000000000000000 用户或合约地址
bytes4 0x00000000 固定 4 字节标识
bytes 空字节序列 0x 任意长度的二进制数据
string 空字符串 "" 名称、说明文字
uint / int 0 数量、差值

bytes4 必须容纳恰好 4 字节,bytes 的长度可变化;string 用于 UTF-8 文本,但它没有直接的字符下标访问能力。例如 bytes(unicode"中").length 为 3,统计的是 UTF-8 字节数而非汉字数。普通地址使用 address;确实需要以地址类型执行 Ether 转账操作时再考虑 address payable,且应单独处理转账安全性。

部署可读取的类型示例

下列完整合约适用于 Solidity 0.8.24。public 状态变量会生成同名读取函数;seed() 仅用于教学演示,因此没有访问控制,不能直接作为生产管理接口。

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

contract StateTypes {
    // 连续声明多个较小的值类型,便于观察实际存储布局
    uint8 public level;
    int16 public adjustment;
    bool public enabled;
    address public operator;
    bytes4 public code;
    bytes public rawData;
    string public nickname;

    function seed() external {
        level = 250;
        adjustment = -12;
        enabled = true;
        operator = msg.sender;
        code = 0x12345678;
        rawData = hex"CAFE";
        nickname = "Alice";
    }

    function increase(uint8 amount) external {
        // 0.8.x 默认检查算术溢出,失败时整笔调用回滚
        level += amount;
    }
}

预期结果(在 Remix 中先部署、读取,再执行相应函数):

text
部署后:
level() -> 0
adjustment() -> 0
enabled() -> false
operator() -> 0x0000000000000000000000000000000000000000
code() -> 0x00000000
rawData() -> 0x
nickname() -> ""

调用 seed() 后:
level() -> 250
adjustment() -> -12
enabled() -> true
operator() -> <ADDRESS>
code() -> 0x12345678
rawData() -> 0xcafe
nickname() -> "Alice"

调用 increase(5) 后:level() -> 255
再次调用 increase(1):交易回滚,level() 仍为 255

<ADDRESS> 代表本次执行 seed() 的账户地址,实际值随 Remix 所选账户变化;区块时间、交易哈希等也不是固定值。

在 Remix 中验证边界

  1. 打开 Remix IDE,在文件浏览器新建 StateTypes.sol,粘贴上面的代码。
  2. 进入 Solidity Compiler,选择 0.8.24 编译;在 Deploy & Run Transactions 中选择 Remix VM 环境,点击 Deploy。
  3. 展开部署后的合约,先逐个点击 level、operator、rawData 等读取按钮,核对零值;再点击 seed,重新读取各变量。
  4. 在 increase 输入 5 并发送交易,确认 level 变为 255;再输入 1,预期执行失败。编译器 0.8.x 的典型错误类型为 Panic(0x11)(算术溢出或下溢),具体界面报错措辞可能不同。

按数据用途检查存储代价

EVM 以 32 字节存储槽为基本单位,但连续声明的小型值类型可能打包在同一槽。本例前五个字段所需字节数分别为 1、2、1、20、4,合计 28 字节,可以装进一个槽;动态 bytes、string 另按动态数据规则存储。不能据此推断“所有 uint8 都比 uint256 省 Gas”:运算、读写方式和字段排列都会影响实际开销。

交付合约前按三项核对类型:数值是否会越界、文本是否需要按 UTF-8 保存、零地址或 false 是否会被误认为有效业务状态。对代币金额优先明确单位和最大值,对固定标识优先确定字节长度,再决定类型和访问控制。

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

目录与阅读设置

阅读设置

17

记录一个想法

为状态变量选择合适类型

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

登录哪都通