Rust 入门教程:从安装到第一个 Hello World

📅 2026/6/27 9:22:06
Rust 入门教程:从安装到第一个 Hello World
Rust 入门教程从安装到第一个 Hello World写给完全初学者的 Rust 指南为什么选择 Rust在开始之前先简单说说 Rust 为什么值得学习内存安全无需垃圾回收编译器在编译期就能防止内存错误高性能速度媲美 C/C并发安全编译器会帮你检查数据竞争丰富的生态Cargo 包管理工具让开发更高效活跃的社区连续多年被评为“最受喜爱的编程语言”无论你是系统编程新手还是资深开发者Rust 都能给你带来全新的编程体验。一、安装 Rust 环境1.1 安装 Rustup推荐方式Rustup 是 Rust 的官方安装器和版本管理工具。打开终端执行以下命令macOS / Linuxcurl--protohttps--tlsv1.2-sSfhttps://sh.rustup.rs|shWindows下载并运行 rustup-init.exe安装过程中会询问安装选项直接选择默认的1) Proceed with installation (default)即可。1.2 验证安装安装完成后重新打开终端验证是否安装成功rustc--version# 输出示例rustc 1.78.0 (9b00956e5 2024-04-29)cargo--version# 输出示例cargo 1.78.0 (54d8815d0 2024-03-26)如果能看到版本号说明安装成功1.3 更新与环境配置更新 Rustrustup update卸载 Rustrustup self uninstall设置默认版本如需rustup default stable二、开发工具推荐好的工具能大幅提升开发效率以下是 Rust 开发的主流选择2.1 VS Code强烈推荐VS Code 是目前 Rust 开发最流行的编辑器配合插件体验极佳。必装插件rust-analyzer- Rust 官方语言服务器代码补全、跳转定义、重命名实时错误提示和类型推断内联文档显示Even Better TOML- 对Cargo.toml配置文件提供语法高亮和校验CodeLLDB或Native Debug- 调试支持可选插件Crates- 显示依赖的最新版本Rust Test Explorer- 图形化运行测试2.2 其他 IDE 选择IntelliJ RustIntelliJ IDEA / CLion 插件- 功能强大适合大型项目RoverVim/Neovim- 轻量级终端爱好者首选Helix- 内置 LSP 支持开箱即用2.3 在线 Playground不想安装环境试试官方在线编辑器Rust Playground可以直接在浏览器中编写和运行 Rust 代码非常适合快速试验。三、创建第一个 Rust 项目Rust 使用Cargo作为构建系统和包管理器类似于 Node.js 的 npm 或 Python 的 pip。3.1 使用 Cargo 创建项目在终端中执行cargonew hello_worldcdhello_world这个命令会生成一个名为hello_world的目录结构如下hello_world/ ├── Cargo.toml # 项目配置文件 └── src/ └── main.rs # 源代码入口文件3.2 项目结构解析Cargo.toml类似于package.json[package] name hello_world version 0.1.0 edition 2021 [dependencies][package]项目元信息[dependencies]在这里添加第三方库src/main.rsRust 源代码fnmain(){println!(Hello, world!);}fn main()程序入口函数println!宏注意有!用于打印到控制台3.3 运行项目有两种方式运行方式一直接运行推荐新手cargorun方式二先编译再运行cargobuild# 编译生成可执行文件./target/debug/hello_world# 运行Windows 下为 .\target\debug\hello_world.exe输出结果Hello, world!3.4 常用 Cargo 命令命令说明cargo new 项目名创建新项目cargo init在当前目录初始化项目cargo build编译项目调试模式cargo build --release编译项目发布模式优化更高cargo run编译并运行cargo check快速检查代码是否通过编译不生成可执行文件cargo test运行测试cargo doc --open生成并打开项目文档小贴士开发时多使用cargo check它比cargo build更快能迅速发现语法错误。四、深入理解 Hello World让我们仔细看看这段代码fnmain(){println!(Hello, world!);}4.1 函数定义fn关键字声明函数main是特殊的函数名它是每个可执行程序的入口点函数体用花括号{}包裹4.2 打印宏println!不是普通函数而是宏macro所以后面有!宏在编译时会展开成更多代码提供更灵活的功能println!会自动在末尾添加换行符如果想不换行可以用print!4.3 字符串字面量Hello, world!是字符串字面量用双引号包裹Rust 的字符串是 UTF-8 编码支持中文等非 ASCII 字符试试修改代码fnmain(){println!(你好世界);println!(Hello, {},Rust);// 使用占位符}运行结果你好世界 Hello, Rust五、常见问题与解决方法5.1 安装失败或速度慢问题从官方源下载太慢。解决使用国内镜像以 ustc 源为例macOS/LinuxexportRUSTUP_DIST_SERVERhttps://mirrors.ustc.edu.cn/rust-staticexportRUSTUP_UPDATE_ROOThttps://mirrors.ustc.edu.cn/rust-static/rustupcurl--protohttps--tlsv1.2-sSfhttps://sh.rustup.rs|sh或配置 cargo 镜像创建或修改~/.cargo/config.toml[source.crates-io] replace-with ustc [source.ustc] registry sparsehttps://mirrors.ustc.edu.cn/crates.io-index/5.2 找不到rustc或cargo命令安装后需要重新打开终端或者手动将 Rust 添加到 PATHsource~/.cargo/env5.3 VS Code 插件不工作确保安装了rust-analyzer插件确认项目根目录有Cargo.toml尝试重启 VS Code 或执行rust-analyzer: Restart server命令六、下一步学什么恭喜你完成了第一个 Rust 程序接下来可以继续学习基础语法变量、数据类型、函数、控制流所有权系统Rust 最核心的概念结构体和枚举自定义数据类型错误处理Result和Option模块系统代码组织与管理实战项目用 Rust 写一个命令行工具或 Web 服务推荐学习资源 The Rust Book官方教程免费在线阅读 Rust 语言圣经中文版非常全面 Rustlings交互式练习强烈推荐 Rust Crash CourseYouTube 视频教程结语Rust 的学习曲线可能会比一些语言陡峭但一旦跨过入门阶段你会发现它带来的安全性和表达力是无可替代的。希望这篇教程能帮你迈出坚实的第一步有任何问题欢迎在评论区留言交流。Happy Coding! 本文首发于个人博客转载请保留原文链接。