sui-build

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Building Packages

构建包

MCP tool: When available in your environment, also query the Sui documentation MCP server (
https://sui.mcp.kapa.ai
) for up-to-date answers. Use it for verification and for details not covered by these reference files.

Source constraint: All information sourced exclusively from docs.sui.io and move-book.com.

MCP工具： 如果你的环境中可用，也可以查询Sui文档MCP服务器（
https://sui.mcp.kapa.ai
）获取最新答案。用它来验证信息，以及获取这些参考文件未涵盖的细节。

来源限制： 所有信息均来自docs.sui.io和move-book.com。

Building

构建

bash

sui move build

This compiles all modules, validates types, enforces resource safety, and produces bytecode. Fix any errors before proceeding.

For the canonical hello-world repository, run build commands from

sui-stack-hello-world/move/hello-world

bash

sui move build

该命令会编译所有模块、验证类型、强制执行资源安全性并生成字节码。继续操作前请修复所有错误。

对于标准的hello-world仓库，请在

sui-stack-hello-world/move/hello-world

目录下运行构建命令。

--build-env

flag

--build-env

参数

When a package has an

[environments]

section in

Move.toml

with multiple networks, use

--build-env

to target a specific environment:

bash

sui move build --build-env testnet
sui move build --build-env mainnet

This resolves dependencies and package addresses for the specified environment. Without

--build-env

, the build uses the default environment or may fail with "Could not determine the correct dependencies" if multiple environments are defined and no default is set.

The

--build-env

flag also applies to

sui move test

bash

sui move test --build-env testnet

如果包的

Move.toml

文件中有

[environments]

部分定义了多个网络，请使用

--build-env

指定目标环境：

bash

sui move build --build-env testnet
sui move build --build-env mainnet

这会解析指定环境的依赖项和包地址。如果没有

--build-env

，构建会使用默认环境；如果定义了多个环境且未设置默认值，可能会失败并提示“无法确定正确的依赖项”。

--build-env

参数同样适用于

sui move test

：

bash

sui move test --build-env testnet

Testing

测试

bash

sui move test

bash

sui move test

Key testing modules

核心测试模块

sui::test_scenario
— Multi-transaction, multi-sender test scenarios. Simulates realistic transaction flows with
```
begin
```
,
```
next_tx
```
, and
```
end
```
.
std::unit_test
— Assertion macros for unit tests (
```
assert_eq!
```
,
```
assert_ne!
```
).

sui::test_scenario
— 支持多交易、多发送者的测试场景。通过
```
begin
```
、
```
next_tx
```
和
```
end
```
模拟真实的交易流程。
std::unit_test
— 用于单元测试的断言宏（
```
assert_eq!
```
、
```
assert_ne!
```
）。

Code coverage

代码覆盖率

Track which lines your tests exercise:

bash

sui move test --coverage

View coverage results for a specific module:

bash

sui move coverage source --module <name>

跟踪测试用例覆盖的代码行：

bash

sui move test --coverage

查看特定模块的覆盖率结果：

bash

sui move coverage source --module <name>

Move Analyzer

Install via suiup:

bash

suiup install move-analyzer

Then install the Move Analyzer extension in VS Code. It provides code completion, go-to-definition, inline diagnostics, and hover documentation. It activates automatically for

.move

files — no additional configuration needed.

通过suiup安装：

bash

suiup install move-analyzer

然后在VS Code中安装Move Analyzer扩展。它提供代码补全、跳转到定义、内联诊断和悬停文档功能。对于

.move

文件会自动激活，无需额外配置。

Debugging

调试

Move Trace Debugger: Step-through debugger for Move execution traces with variable inspection.
sui replay
: Locally re-execute any past onchain transaction and compare effects. Useful for diagnosing production issues.
std::debug::print
: Print values during test execution.

Move Trace Debugger： 用于Move执行轨迹的单步调试器，支持变量检查。
sui replay
：本地重新执行任何已上链的过往交易并对比效果。适用于诊断生产环境问题。
std::debug::print
：在测试执行过程中打印值。

sui-build

Original

Translation

Building Packages

构建包

Building

构建

`--build-env`
flag

`--build-env`
参数

Testing

测试

Key testing modules

核心测试模块

Code coverage

代码覆盖率

Move Analyzer

Move Analyzer

Debugging

调试