智能合约与以太坊 / 系统课时
为状态变量选择合适类型
为状态变量选择合适类型
为 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~ | 代币数量、累计计数 |
int16 |
-32768~32767 | 有正负方向的调整量 |
int256 |
~ | 大范围有符号计算 |
例如等级最大值为 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() 仅用于教学演示,因此没有访问控制,不能直接作为生产管理接口。
// 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 中先部署、读取,再执行相应函数):
部署后:
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 中验证边界
- 打开 Remix IDE,在文件浏览器新建
StateTypes.sol,粘贴上面的代码。 - 进入 Solidity Compiler,选择
0.8.24编译;在 Deploy & Run Transactions 中选择 Remix VM 环境,点击 Deploy。 - 展开部署后的合约,先逐个点击
level、operator、rawData等读取按钮,核对零值;再点击seed,重新读取各变量。 - 在
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 是否会被误认为有效业务状态。对代币金额优先明确单位和最大值,对固定标识优先确定字节长度,再决定类型和访问控制。