Introduction to Cargo - The Essential Tool for Rust Developers | Rust The Series EP.3

Welcome back to Rust The Series SS1, the series designed to take you from zero to Rust hero with Superdev Academy!

In EP 1 and 2, we covered the history of Rust and got our environment ready. Now, in EP 3, we are finally going to "write" and "run" our very first piece of code. But before we dive into the syntax, we need to meet the tool that every Rustacean swears by: Cargo.

Why Cargo? More Than Just a Package Manager

If Java has Maven/Gradle, Python has Pip, and Node.js has NPM... Rust has Cargo. However, Cargo is often considered more "complete" because it is an All-in-one tool that comes pre-installed with Rust.

It is widely regarded as one of the best project management systems in the programming world because it makes development incredibly stable and easy to manage.

1. Creating Your First Project with cargo new

Open your Terminal (or Command Prompt) and type the following command to create a new project:

Bash

cargo new hello_superdev
cd hello_superdev

Once you open this folder (we recommend using VS Code), you’ll see the standard Rust project structure:

• Cargo.toml: The "heart" of your project (The Manifest) containing metadata and dependencies.

• src/: The folder where all your source code lives.

• src/main.rs: The main file where we write our code.

• .gitignore: Automatically generated for those using Git/GitHub.

2. Deep Dive: The Cargo.toml (Manifest)

This file uses the TOML (Tom's Obvious, Minimal Language) format, which is designed to be human-readable:

Ini, TOML

[package]
name = "hello_superdev"
version = "0.1.0"
edition = "2021"

[dependencies]
# This is where you add external libraries, e.g., serde = "1.0"

• [package]: Contains general info like the project name, version, and the Rust edition.

• [dependencies]: When you want to add "superpowers" to your app (like handling JSON or building a Web API), you'll list those libraries here.

3. The "Hello World" in main.rs

Look inside src/main.rs. You'll notice that Cargo has already written the boilerplate code for you!

Rust

fn main() {
    println!("Hello, world!");
}

Code Analysis:

• fn main(): This is the Entry Point of every Rust program. Execution starts here.

• println!: This is a Macro (notice the !). It prints text to the console. In Rust, macros are used here instead of regular functions because they can handle a variable number of arguments with type safety.

4. The 3 Essential Commands to Remember

As you develop in Rust, you will use these three commands constantly:

A. cargo build (Compile)

This compiles your code and creates an executable file in the target/debug/ folder.

B. cargo run (Build & Run)

The most popular command! It checks if your code has changed, recompiles it if necessary, and then runs the program immediately.

Result: You should see "Hello, world!" printed on your screen.

C. cargo check (The Speed Demon)

This command scans your code for errors and syntax mistakes but does not generate an executable. It is much faster than a full build, making it perfect for checking your code frequently while you type.

5. Building for Release (Production Mode)

When your program is finished and you want to share it or deploy it, use:

Bash

cargo build --release

Why use --release?

In standard mode (Debug), Rust focuses on fast compilation for development. In Release mode, the compiler performs heavy Optimizations to make your program run as fast as possible. The final executable will be located in target/release/.

Summary

In this EP, we’ve learned how to use Cargo to manage projects, understood the Cargo.toml structure, and ran our first "Hello World" using cargo run.

Having a world-class tool like Cargo allows us to focus entirely on writing logic without worrying about the messy build configurations common in older languages like C++.

Next Step:

In EP 4, we dive into the most critical fundamental: Variables & Mutability. We’ll answer the big question: Why are Rust variables "Immutable" (unchangeable) by default, and how do we change them when we need to?

See you at Superdev Academy! 🦀✨

🎯 Stay Tuned with Superdev Academy:

Don't miss out on deep-dive technical articles and updates. Follow us on all platforms:

• 🔵 Facebook: Superdev Academy Thailand

• 🎬 YouTube: Superdev Academy Channel

• 📸 Instagram: @superdevacademy

• 🎬 TikTok: @superdevacademy

• 🌐 Website: superdevacademy.com