Linux环境下Rust编译器的使用指南

先说几个关键点：Rust的安装并没有想象中那么复杂，官方推荐的方式是通过rustup这个工具来管理整个工具链，包括编译器rustc、包管理器cargo等等。具体操作步骤并不复杂，把终端打开，一行命令就能搞定。

一、安装Rust编译器

1. 使用官方脚本安装（推荐）

打开终端，运行以下命令，脚本会自动下载并执行安装：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装过程中，脚本会弹出几个选项，默认选1（即默认安装）就行，一路回车也没什么问题。装完之后，脚本会提示你重启终端，或者手动执行下面这条命令来加载环境变量：

source $HOME/.cargo/env

2. 验证安装

装完之后，总得确认一下是否真的装好了吧？用下面两条命令来查看版本，是最直接的方式：

rustc --version# 查看Rust编译器版本cargo --version# 查看Cargo包管理器版本

如果输出类似rustc 1.82.0 (f6e511eec 2024-10-15)这样的信息，那就说明安装成功了。这一步其实很关键，因为环境变量不加载的话，系统就找不到rustc命令。

3. 可选：通过包管理器安装（部分发行版）

如果你用的发行版比较保守，或者不喜欢用curl，那也可以直接用系统自带的包管理器来装。不过需要注意的是，这样安装的版本可能不是最新的。下面列出几个常见发行版的安装命令：

# Ubuntu/Debiansudo apt updatesudo apt install rustc cargo# Fedorasudo dnf install rust cargo# Arch Linuxsudo pacman -S rust cargo

4. 更新Rust工具链

Rust的更新频率其实挺快的，用rustup可以一键更新到最新稳定版：

rustup update

二、创建Rust项目

用cargo创建项目，基本就是标准动作了：

cargo new 项目名称# 如 cargo new hello_worldcd 项目名称

运行之后，cargo会自动生成一个项目文件夹，结构如下：

项目名称/├── Cargo.toml# 项目配置文件（依赖管理、元数据等）└── src/└── main.rs # 主程序入口文件（默认包含"Hello, world!"示例）

简单来说，Cargo.toml就是项目的“身份证”，记录了项目名称、版本、依赖等信息；而src/main.rs则是代码的主入口，默认会打印一句“Hello, world!”。

三、编译与运行Rust程序

1. 编译项目

在项目根目录下，运行以下命令即可编译：

cargo build# 编译为调试版本cargo build --release# 编译为发布版本

调试版本说白了就是带着详细调试信息的版本，方便你调试代码；发布版本则是经过深度优化的，跑起来更快，适合真正上线用。编译后的文件分别放在target/debug/和target/release/目录下。

2. 运行项目

其实也不用每次都手动编译，直接用cargo run就能一步到位：

cargo run# 运行调试版本cargo run --release# 运行发布版本

如果编译通过，终端就会输出程序跑出来的结果，比如Hello, world!，简单直接。

3. 直接使用rustc编译（可选）

如果只是写个简单的单文件程序，不想折腾cargo，那直接用rustc编译也行：

rustc main.rs./main

这种方式的优点就是快，但仅限于小项目。一旦项目复杂起来，依赖多了，还是老老实实用cargo吧。

四、常用编译选项

rustc本身也支持不少编译选项，下面挑几个常用的说说。

1. 指定输出文件名

默认编译出来的可执行文件叫main，但如果你想换个名字，可以用-o选项：

rustc main.rs -o my_program./my_program

2. 启用调试信息

如果需要用GDB之类的调试器来调试，-g选项就派上用场了：

rustc -g main.rs

这个选项等价于-C debuginfo=2，生成的调试信息更完整。

3. 开启优化

想提升程序性能？用-O选项开启优化：

rustc -O main.rs

等价于-C opt-level=2，是一个比较平衡的优化级别。

4. 链接外部库

如果项目需要链接外部的C库，可以用-L和-l选项：

rustc -L. -lmylib main.rs

这里-L.表示把当前目录加到库搜索路径中，-lmylib则告诉编译器去链接libmylib.so或libmylib.a。

5. 指定crate类型

默认编译出来的是可执行文件，但有时候你可能需要生成静态库或动态库，这时候可以用--crate-type选项：

rustc --crate-type bin main.rs # 编译为可执行文件rustc --crate-type staticlib main.rs# 编译为静态库rustc --crate-type dylib main.rs# 编译为动态库

五、常见问题解决

1. 环境变量问题

如果安装后终端提示rustc: command not found，那八成是环境变量没配好。解决方法很简单，手动把~/.cargo/bin加到PATH里：

echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc

2. 依赖问题

编译时如果提示缺少某些系统依赖，比如libssl，直接用系统的包管理器装一下就行：

# Ubuntu/Debiansudo apt install libssl-dev# Fedorasudo dnf install openssl-devel

3. 卸载Rust

如果哪天想卸载Rust，直接运行以下命令：

rustup self uninstall

这条命令会删除~/.cargo目录里的所有内容，包括工具链、配置文件等，相当于把整个环境恢复了出厂设置。

安装配置完毕，基本操作也梳理清楚了。从环境搭建到项目创建，再到编译运行和常见问题的处理，这套流程走下来，Linux下用Rust进行开发应该就没太大问题了。