本节是《Solidity by Example》的中文翻译与深入讲解，专为零基础或刚接触区块链开发的小白朋友打造。我们将通过“示例 + 解说 + 提示”的方式，带你逐步理解每一段 Solidity 代码的实际用途与背后的逻辑。
Solidity 是以太坊等智能合约平台使用的主要编程语言，就像写网页要用 HTML 和 JavaScript，写智能合约就需要会 Solidity。
如果你从没写过区块链代码也没关系，只要你了解一点点编程概念，比如“变量”“函数”“条件判断”，我们就能从最简单的例子开始，一步步建立你的 Solidity 编程思维。
Reading and Writing to a State Variable
读写状态变量
要写入或更新状态变量，你需要发送一笔交易。 另一方面，你可以免费读取状态变量，无需支付交易费用
- 状态变量：状态变量是存储在区块链上的数据（例如一个数字或字符串），它们是智能合约的“持久化”数据，类似于数据库中的记录。
- 写入状态变量：
- 修改状态变量（例如更新一个数字）需要发送一笔交易（transaction）。
- 交易会改变区块链的状态，因此需要支付 Gas 费用（以太坊的计算和存储费用）。
- 交易必须由用户或另一个合约发起，并由区块链网络确认。
- 读取状态变量：
- 读取状态变量（例如查看当前值）不需要发送交易。
- 如果通过 链下调用（off-chain call，例如通过 Web3 库查询），读取是免费的，因为它不会改变区块链状态。
- 通常，读取函数会标记为
view，表示它们只读数据，不消耗 Gas。
// SPDX-License-Identifier: MIT
// 声明代码采用 MIT 开源许可证，这是一种常见的开源许可协议，允许自由使用、修改和分发代码。
pragma solidity ^0.8.26;
// 指定 Solidity 编译器版本必须大于或等于 0.8.26 并且小于 0.9.0。
// `pragma` 指令确保合约使用兼容的编译器版本，`^0.8.26` 表示支持 0.8.26 或更高版本（但不超过 0.9.0）。
contract SimpleStorage {
// 定义一个名为 `SimpleStorage` 的智能合约。
// 合约是一个运行在以太坊区块链上的程序，包含数据（状态变量）和逻辑（函数）。
// 这个合约的目的是展示如何读写状态变量。
// State variable to store a number
// 用于存储数字的状态变量
uint256 public num;
// 声明一个名为 `num` 的状态变量，类型为 `uint256`（256 位无符号整数，范围从 0 到 2^256-1）。
// `public` 关键字表示该变量可以被外部访问，Solidity 会自动为其生成一个 getter 函数（类似于 `function num() public view returns (uint256)`）。
// 未初始化，默认值为 0，存储在区块链上。
// You need to send a transaction to write to a state variable.
// 你需要发送一笔交易来写入状态变量。
function set(uint256 _num) public {
// 定义一个名为 `set` 的公共函数，用于更新状态变量 `num`。
// 接受一个参数 `_num`，类型为 `uint256`，表示要设置的新值。
// `public` 表示函数可以被外部调用（用户、其他合约或 DApp）。
// 没有 `view` 或 `pure` 修饰符，表示函数会修改区块链状态，需要消耗 Gas。
num = _num;
// 将状态变量 `num` 的值更新为传入的参数 `_num`。
// 修改状态变量会触发区块链存储更新，因此需要发送交易并支付 Gas。
}
// You can read from a state variable without sending a transaction.
// 你可以无需发送交易即可读取状态变量。
function get() public view returns (uint256) {
// 定义一个名为 `get` 的公共函数，用于读取状态变量 `num` 的值。
// `public` 表示函数可以被外部调用。
// `view` 修饰符表示函数只读取区块链数据，不修改任何状态，因此链下调用免费。
// 返回值类型为 `uint256`，表示返回 `num` 的当前值。
return num;
// 返回状态变量 `num` 的当前值。
}
}
SimpleStorage 是一个简单的智能合约，展示了如何在以太坊区块链上读写状态变量。它包含：
- 一个状态变量
num，用于存储一个数字（初始值为 0）。 - 一个函数
set，用于更新num的值（写入操作）。 - 一个函数
get，用于查看num的当前值（读取操作）。
代码做什么？
- 状态变量
num：- 存储一个数字，永久保存在区块链上。
- 因为是
public，可以直接通过 getter 函数（num()）或get函数读取。
- 写入操作（
set函数）：- 接受一个新数字
_num，更新num的值。 - 修改区块链上的数据需要发送交易，消耗 Gas。
- 例如，调用
set(42)会将num改为 42。
- 接受一个新数字
- 读取操作（
get函数）：- 返回
num的当前值。 - 只读取数据，不修改区块链状态，因此链下调用免费。
- 例如，调用
get()会返回当前的num值（如 42）。
- 返回
- Gas 成本：
- 部署合约时，初始化
num（默认 0）需要 Gas。 - 调用
set函数修改num需要 Gas（因为更改区块链状态）。 - 调用
get函数或num的 getter 函数是view操作，链下调用不消耗 Gas。
- 部署合约时，初始化
关键点：
- 状态变量：
- 存储在区块链的
storage中，永久保存。 - 修改需要交易和 Gas，读取通常免费。
- 存储在区块链的
- 交易 vs. 调用：
- 交易（Transaction）：修改区块链状态（如调用
set），需要 Gas，记录在区块链上。 - 调用（Call）：只读取数据（如调用
get），链下免费，不记录在区块链上。
- 交易（Transaction）：修改区块链状态（如调用
- 公共变量：
public变量自动生成 getter 函数，功能与get函数类似。- 例如，
num本身可以直接查询，等价于调用get。
- 用途：
- 读写状态变量是智能合约的核心功能，广泛用于存储用户数据、记录状态或实现业务逻辑。
- 例如，
SimpleStorage可以用来记录一个计数器、用户余额或其他持久化数据。
读写状态变量的注意事项
- 写入需要交易：
- 任何修改状态变量的操作（如
set）都需要发送交易，消耗 Gas。 - 交易失败（例如 Gas 不足或逻辑错误）会导致状态回滚，但已消耗的 Gas 不退还。
- 任何修改状态变量的操作（如
- 读取免费：
view函数（如get）或public变量的 getter 函数在链下调用免费。- 如果在链上调用（例如另一个合约调用
get），会消耗少量 Gas。
- 状态变量的存储成本：
- 状态变量存储在区块链的
storage中，占用空间较大，初始化和修改成本高。 - 选择合适的类型（如
uint8比uint256更省空间）可以优化 Gas。
- 状态变量存储在区块链的
- 安全性：
public变量可以被任何人读取，注意不要存储敏感数据。- 修改状态变量时，考虑添加权限控制（例如只有管理员可以调用
set）。
- 溢出检查：
- 在 Solidity 0.8.0+ 中，
uint256的算术运算自动检查溢出/下溢，失败时交易会回滚。
- 在 Solidity 0.8.0+ 中，