1 个不稳定版本

使用旧的 Rust 2015

0.1.0	2018年3月23日

2119 在异步

81 每月下载

MIT/Apache

2KB

Tokio

Tokio 是一个用于使用 Rust 编程语言编写可靠、异步和精简应用程序的运行时。它是

快速：Tokio 的零成本抽象为您提供了裸机性能。
可靠：Tokio 利用 Rust 的所有权、类型系统和并发模型来减少错误并确保线程安全。
可扩展：Tokio 脚印最小，并能自然地处理背压和取消。

网站 | 指南 | API 文档 | 聊天

概述

Tokio 是一个基于 Rust 编程语言编写异步应用程序的事件驱动、非阻塞 I/O 平台。在较高层面，它提供了一些主要组件

一个基于多线程和任务窃取的调度器。
一个由操作系统的事件队列（epoll、kqueue、IOCP 等）支持的反应器。
异步 TCP 和 UDP 套接字。

这些组件为构建异步应用程序提供了必要的运行时组件。

示例

使用 Tokio 的基本 TCP 反射服务器。

确保在 Cargo.toml 中激活了 tokio crate 的全部功能

[dependencies]
tokio = { version = "1.39.1", features = ["full"] }

然后，在你的 main.rs 中

use tokio::net::TcpListener;
use tokio::io::{AsyncReadExt, AsyncWriteExt};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let listener = TcpListener::bind("127.0.0.1:8080").await?;

    loop {
        let (mut socket, _) = listener.accept().await?;

        tokio::spawn(async move {
            let mut buf = [0; 1024];

            // In a loop, read data from the socket and write the data back.
            loop {
                let n = match socket.read(&mut buf).await {
                    // socket closed
                    Ok(n) if n == 0 => return,
                    Ok(n) => n,
                    Err(e) => {
                        eprintln!("failed to read from socket; err = {:?}", e);
                        return;
                    }
                };

                // Write the data back
                if let Err(e) = socket.write_all(&buf[0..n]).await {
                    eprintln!("failed to write to socket; err = {:?}", e);
                    return;
                }
            }
        });
    }
}

更多示例可以在这里找到。对于更大的“现实世界”示例，请参阅 mini-redis 仓库。

要查看可以启用的功能标志列表，请参阅我们的文档。

获取帮助

首先，查看您的问题答案是否可以在指南或API 文档中找到。如果答案不在那里，Tokio Discord服务器中有一个活跃的社区。我们很乐意尝试回答您的问题。您也可以在讨论页面上提问。

贡献

🎈 感谢您为改进项目做出的贡献！我们非常高兴有您的加入！我们有一个贡献指南，以帮助您参与到Tokio项目中。

除了这个存储库中的crates，Tokio项目还维护了几个其他库，包括

axum：一个注重易用性和模块化的Web应用框架。
hyper：一个为Rust提供的快速且正确的HTTP/1.1和HTTP/2实现。
tonic：一个专注于高性能、互操作性和灵活性的gRPC over HTTP/2实现。
warp：一个超简单的、可组合的、高速的Web服务器框架。
tower：一个构建健壮的客户端和服务器所需的模块化和可重用组件库。
tracing（以前称为tokio-trace）：一个用于应用程序级跟踪和异步感知诊断的框架。
mio：一个在tokio背后运行的跨平台抽象层，它封装了操作系统I/O API。
bytes：用于处理字节的实用程序，包括高效的字节缓冲区。
loom：一个用于并发Rust代码的测试工具。

变更日志

Tokio存储库包含多个crates。每个crates都有自己的变更日志。

tokio - 查看变更日志
tokio-util - 查看变更日志
tokio-stream - 查看变更日志
tokio-macros - 查看变更日志
tokio-test - 查看变更日志

支持的Rust版本

Tokio将保持至少6个月的滚动MSRV（最低支持的Rust版本）政策。在提高MSRV时，新的Rust版本必须至少发布6个月前。当前的MSRV是1.70。

请注意，MSRV不会自动提高，并且只作为小版本发布的一部分。以下是过去小版本发布的MSRV历史记录：

1.39至今 - Rust 1.70
1.30至1.38 - Rust 1.63
1.27至1.29 - Rust 1.56
1.17至1.26 - Rust 1.49
1.15至1.16 - Rust 1.46
1.0至1.14 - Rust 1.45

请注意，尽管我们试图避免Tokio间接增加MSRV的情况，但我们不能保证这种情况不会发生。然而，每个小版本都将有一组与该小版本MSRV兼容的依赖版本。

发布计划

Tokio不遵循固定的发布计划，但我们通常每个月发布一到两个新的小版本。如有必要，我们会进行补丁发布以修复错误。

错误修补策略

为了制作带有错误修复的补丁版本，我们已将某些小版本标记为LTS（长期支持）版本。每当出现需要发布带有错误修复的补丁版本时，它将被回滚并作为每个LTS小版本的新的补丁版本发布。我们的当前LTS版本包括：

1.32.x - LTS版本，直到2024年9月。（MSRV 1.63）
1.36.x - LTS版本，直到2025年3月。（MSRV 1.63）
1.38.x - LTS版本，直到2025年7月。（MSRV 1.63）

每个LTS版本将继续至少一年内接收回滚的修复。如果您希望在项目中使用修复后的版本，我们建议您使用LTS版本。

要使用修复后的版本，您可以使用波浪号指定版本。例如，要指定使用最新的1.32.x补丁版本，您可以使用以下依赖指定：

tokio = { version = "~1.32", features = [...] }

以前的LTS版本

1.8.x - LTS版本，直到2022年2月。
1.14.x - LTS版本，直到2022年6月。
1.18.x - LTS版本，直到2023年6月。
1.20.x - LTS版本，直到2023年9月。
1.25.x - LTS版本，直到2024年3月。

许可证

本项目受MIT许可证许可。

贡献

除非您明确声明，否则您提交给Tokio的任何贡献，均应按照MIT许可进行，不附加任何额外条款或条件。

依赖

~1MB
~15K SLoC