Tokio

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

• 快速：Tokio的无成本抽象为您提供裸机性能。

• 可靠：Tokio利用Rust的所有权、类型系统和并发模型来减少错误并确保线程安全。

• 可扩展：Tokio具有最小的内存占用，并自然处理背压和取消。

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

概述

Tokio是使用Rust编程语言编写的异步应用程序的事件驱动、非阻塞I/O平台。从高层次来看，它提供了一些主要组件

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

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

示例

使用Tokio的基本TCP回声服务器。

确保在Cargo.toml中激活了tokio crate的完整功能

[dependencies]
tokio = { version = "1.38.0", 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 项目。

相关项目

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

• axum：一个专注于易用性和模块化的 Web 应用程序框架。

• hyper：Rust 的一个快速且正确的 HTTP/1.1 和 HTTP/2 实现。

• tonic：一个专注于高性能、互操作性和灵活性的 gRPC over HTTP/2 实现。

• warp：一个超级简单、可组合的 Web 服务器框架，速度极快。

• tower：用于构建强大网络客户端和服务器的一组模块化和可重用组件的库。

• tracing（以前称为 tokio-trace）：一个用于应用级跟踪和异步诊断的框架。

• mio：一个低级别、跨平台的 OS I/O API 抽象，为 tokio 提供动力。

• bytes：用于处理字节的一些实用工具，包括高效的字节缓冲区。

• loom：用于并发 Rust 代码的测试工具。

变更日志

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

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

支持的 Rust 版本

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

请注意，MSRV 不会自动提高，并且仅在作为次要版本的一部分时才会提高。以下列出了过去次要版本的 MSRV 历史

• 1.30 到现在 - 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 - 直到2024年9月为LTS版本。（MSRV 1.63）
• 1.36.x - 直到2025年3月为LTS版本。（MSRV 1.63）

每个LTS版本将继续至少一年接收回溯的修复。如果您想在项目中使用固定的小版本，我们建议您使用LTS版本。

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

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

以前的LTS版本

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

许可证

此项目使用 MIT许可证。

贡献

除非您明确表示，否则您提交给Tokio的任何有意贡献都应按MIT许可证许可，不附加任何额外条款或条件。