使用Rust编写推箱子游戏基础篇

最新推荐文章于 2025-10-30 20:38:05 发布

原创

最新推荐文章于 2025-10-30 20:38:05 发布 · 1.1k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#编程语言 #rust #Cargo #游戏 #开发

本文档教程详细介绍了如何使用Rust编程语言和ggez游戏引擎来创建一个推箱子游戏。首先，介绍了推箱子游戏的玩法和ECS（实体构建系统）的概念。接着，逐步展示了如何通过Rust创建结构体、实现系统特征、注册组件、创建实体以及构建游戏世界。然后，作者引导读者理解Rust的生命周期、组件和实体的概念，并实现了一个简单的渲染系统，用于在窗口上绘制游戏元素。最后，通过创建测试实体并运行代码，验证了渲染系统的有效性。

使用Rust编写推箱子游戏教程已翻译完成项目地址在线阅读

$ rustc --version 
rustc 1.40.0

$ cargo --version 
cargo 1.40.0

输出的版本信息未必都是这样的，但建议使用比较新的Rust版本。

创建项目

Cargo是Rust的包管理工具，可以使用它创建我们的游戏项目。首先切换到游戏项目存储路径，然后再输入以下命令：

$ cargo init rust-sokoban

命令执行成功后，会在当前目录下创建一个名称为rust-sokoban的文件夹。文件夹内部是这个样子的：

├── src

│ └── main.rs

└── Cargo.toml

切换到文件夹rust-sokoban并运行命令 cargo run ，你会看到类似下面的输出信息：

$ cargo run

Compiling rust-sokoban v0.1.0

Finished dev [unoptimized + debuginfo] target(s) in 1.30s

Running `../rust-sokoban/target/debug/rust-sokoban`

Hello, world!

添加游戏开发依赖

接下来让我们一起把默认生成的项目修改成一个游戏项目! 我们使用当前最受欢迎的2D游戏引擎之一的ggez

还记得我们刚才在项目目录里看到的Cargo.toml文件吧？这个文件是用来管理项目依赖的，所以需要把我们需要使用到的crate添加到这个文件中。就像这样添加 ggez 依赖：

[dependencies] ggez = "0.5.1"

MORE: 更多关于Cargo.toml的信息可以看这里.

接下来再次执行cargo run.这次执行的会长一点，因为需要从crates.io下载我们配置的依赖库并编译链接到我们库中。

cargo run

Updating crates.io index Downloaded .... ....

Compiling .... ....

Finished dev [unoptimized + debuginfo] target(s) in 2m 15s

Running `.../rust-sokoban/target/debug/rust-sokoban`

Hello, world!

NOTE: 如果你是使用的Ubuntu操作系统，在执行命令的时候可能会报错，如果报错信息有提到alsa 和libudev可以通过执行下面的命令安装解决： sudo apt-get install libudev-dev libasound2-dev.

接下来我们在main.rs文件中使用ggez创建一个窗口。只是创建一个空的窗口，代码比较简单：

use ggez::{conf, event, Context, GameResult};
use std::path;

// This struct will hold all our game state
// For now there is nothing to be held, but we'll add
// things shortly.
struct Game {}

// This is the main event loop. ggez tells us to implement
// two things:
// - updating
// - rendering
impl event::EventHandler for Game {
    fn update(&mut self, _context: &mut Context) -> GameResult {
        // TODO: update game logic here
        Ok(())
    }

    fn draw(&mut self, _context: &mut Context) -> GameResult {
        // TODO: update draw here
        Ok(())
    }
}

pub fn main() -> GameResult {
    // Create a game context and event loop
    let context_builder = ggez::ContextBuilder::new("rust_sokoban", "sokoban")
        .window_setup(conf::WindowSetup::default().title("Rust Sokoban!"))
        .window_mode(conf::WindowMode::default().dimensions(800.0, 600.0))
        .add_resource_path(path::PathBuf::from("./resources"));

    let (context, event_loop) = &mut context_builder.build()?;
    // Create the game state
    let game = &mut Game {};
    // Run the main event loop
    event::run(context, event_loop, game)
}

可以把代码复制到main.rs文件中，并再次执行cargo run,你会看到:

Screenshot

基本概念和语法

现在我们有了个窗口，我们创建了个窗口耶！接下来我们一起分析下代码并解释下使用到的Rust概念和语法。

引入

您应该在其它编程语言中也接触过这个概念，就是把我们需要用到的依赖包（或crate）里的类型和命名空间引入到当前的代码作用域中。在Rust中，使用use实现引入功能:

// 从ggez命名空间引入conf, event, Context 和 GameResult

use ggez::{conf, event, Context, GameResult};

结构体声明

// This struct will hold all our game state

// For now there is nothing to be held, but we'll add

// things shortly.

struct Game {}

MORE: 查看更多结构体相关信息可以点这里.

最低0.47元/天解锁文章

使用Rust编写推箱子游戏基础篇

推箱子是个啥样的游戏嘞?

为什么要使用Rust编写推箱子游戏呢?

那是不是得先去学习下Rust呢?

项目搭建