Mulai dengan Rust

Ayo jalankan Rust di komputermu dan buat program pertamamu. Kalau kamu belum mau menginstal apa pun, kamu bisa mengikuti pelajaran ini di Rust Playground (tempat menjalankan Rust di browser), lalu kembali ke halaman ini nanti.

Langkah 1: Instal Rust dengan rustup

Cara resmi untuk menginstal Rust adalah lewat tool bernama rustup. Tool ini menginstal compiler Rust dan build tool cargo, sekaligus menjaga semuanya tetap ter-update.

Buka rustup.rs dan ikuti petunjuk untuk sistem operasimu:

• Windows: unduh dan jalankan rustup-init.exe, lalu terima opsi default-nya.

• macOS / Linux: tempelkan perintah ini di terminal:

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

Catatan

Di Windows, Rust membutuhkan C++ build tools. Kalau installer memintanya, biarkan ia menginstal “Visual Studio C++ Build Tools”. Rust memakainya untuk me-link programmu.

Langkah 2: Pastikan instalasinya berhasil

Tutup lalu buka lagi terminalmu, kemudian jalankan:

rustc --version
cargo --version

Kamu seharusnya melihat nomor versi seperti rustc 1.xx.0. Kalau sudah muncul, kamu siap mulai.

• rustc adalah compiler Rust (yang mengubah kodemu menjadi program).
• cargo adalah tool serba bisa milik Rust untuk mem-build, menjalankan, menguji, dan mengelola proyek. Kamu akan memakai cargo untuk hampir semua hal.

Langkah 3: Buat proyek pertamamu

Daripada membuat file satu per satu secara manual, biarkan cargo menyiapkan proyek untukmu:

cargo new hello_rust
cd hello_rust

Perintah ini membuat folder bernama hello_rust yang berisi semua yang dibutuhkan proyek Rust:

hello_rust/
├── Cargo.toml      # pengaturan proyek dan dependensi
└── src/
    └── main.rs     # kodemu ditulis di sini

• Cargo.toml menjelaskan proyekmu (nama, versi, dan library apa saja yang dipakai).
• src/main.rs adalah file awalnya. cargo bahkan sudah mengisinya dengan program Hello World untukmu.

Langkah 4: Jalankan programnya

Dari dalam folder proyek, jalankan:

cargo run

Kamu akan melihat cargo meng-compile proyeknya, lalu mencetak:

Hello, world!

Selesai, kamu baru saja mem-build dan menjalankan program Rust.

Memahami kodenya

Buka src/main.rs dan kamu akan menemukan:

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

• fn main() { ... } mendefinisikan fungsi main. Setiap program Rust mulai berjalan dari sini.
• println!("...") mencetak satu baris teks ke layar.

Pesan Hello, world! itu dibuat otomatis oleh cargo, jadi masih dalam bahasa Inggris. Coba ganti pesannya dan jalankan cargo run lagi:

fn main() {
    println!("Halo dari program Rust pertamaku!");
}

Output:

Halo dari program Rust pertamaku!

▶ Coba sendiri

cargo run vs cargo build

Dua perintah yang akan terus kamu pakai:

Perintah	Fungsinya
cargo run	Meng-compile dan menjalankan programmu (paling cocok saat development)
cargo build	Hanya meng-compile. Programnya disimpan di target/debug/
cargo build --release	Meng-compile versi yang sudah dioptimasi dan lebih cepat, untuk dirilis

Kalau ada yang salah: membaca pesan error compiler

Kamu pasti akan melihat error dari compiler, setiap hari, bahkan setelah bertahun-tahun memakai Rust. Itu bukan tanda kamu payah. Itu tanda compiler sedang menjalankan tugasnya. Ayo kita buat satu error dengan sengaja supaya tidak terlalu menakutkan saat pertama kali melihatnya.

Hapus tanda ! dari println! di src/main.rs:

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

Jalankan cargo run, dan kamu akan mendapat:

error[E0423]: expected function, found macro `println`
 --> src/main.rs:2:5
  |
2 |     println("Hello, world!");
  |     ^^^^^^^ not a function
  |
help: use `!` to invoke the macro
  |
2 |     println!("Hello, world!");
  |            +

Pesan error compiler selalu dalam bahasa Inggris. Baca dari atas ke bawah:

1. Baris pertama memberi tahu apa yang salah: Rust mengharapkan sebuah fungsi (expected function), tapi println ternyata sebuah makro (macro). Kamu akan belajar artinya di halaman berikutnya.
2. --> src/main.rs:2:5 memberi tahu lokasinya: file src/main.rs, baris 2, kolom 5.
3. Tanda ^^^^^^^ menunjuk tepat ke bagian kode yang bermasalah.
4. Bagian help: sering menunjukkan cara memperbaikinya. Di sini bahkan tanda ! yang hilang ditandai dengan +.

Kembalikan tanda !, dan semuanya berjalan lagi:

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

Output:

Hello, world!

▶ Coba sendiri

Cara mengecek yang lebih cepat

cargo check mencari error tanpa mem-build program yang bisa dijalankan. Di proyek yang lebih besar, perintah ini jauh lebih cepat daripada cargo build, jadi banyak orang menjalankannya terus-menerus selagi menulis kode. Kode E0423 juga bisa dicari: rustc --explain E0423 mencetak penjelasan yang lebih panjang beserta contohnya (dalam bahasa Inggris).

Langkah 5: Siapkan editormu (disarankan)

Supaya pengalaman ngoding paling nyaman, instal ekstensi rust-analyzer di editormu. Ekstensi ini memberimu autocompletion, pesan error langsung di dalam kode, dan petunjuk tipe selagi kamu mengetik.

• VS Code: instal ekstensi rust-analyzer
• Kebanyakan editor lain (JetBrains, Neovim, dan lainnya) juga mendukung rust-analyzer.

Tips

Biarkan pesan error compiler tetap terlihat selama kamu belajar. Pesan error Rust terkenal sangat membantu: biasanya menjelaskan apa yang salah dan bagaimana cara memperbaikinya.

Latihan

1. Tiga baris

Buat programmu mencetak tiga baris: namamu, makanan favoritmu, dan Saya baru saja menjalankan Rust!. Petunjuk: satu println! mencetak satu baris, jadi pakai tiga.

Lihat solusi

fn main() {
    println!("Nama saya Sam");
    println!("Saya suka nasi goreng");
    println!("Saya baru saja menjalankan Rust!");
}

Output:

Nama saya Sam
Saya suka nasi goreng
Saya baru saja menjalankan Rust!

▶ Coba sendiri

2. Banner mini

Cetak banner kecil seperti di bawah ini, dengan sebaris tanda = di atas dan di bawah judulnya. Lalu rusak programnya dengan sengaja dengan menghapus sebuah !, jalankan cargo run, baca error-nya, dan perbaiki. Petunjuk: baris = itu hanyalah teks di dalam println!, sama seperti pesan lainnya.

Lihat solusi

fn main() {
    println!("==============");
    println!("  HALO RUST");
    println!("==============");
}

Output:

==============
  HALO RUST
==============

▶ Coba sendiri

Ringkasan

• Instal Rust dengan rustup dari rustup.rs.
• Pastikan berhasil dengan rustc --version dan cargo --version.
• Buat proyek dengan cargo new, jalankan dengan cargo run.
• Sebuah proyek punya Cargo.toml (pengaturan) dan src/main.rs (kodemu).
• Baca pesan error compiler dari atas ke bawah: apa yang salah, di mana, dan sering ada help: berisi cara memperbaikinya.
• Instal rust-analyzer di editormu supaya belajar jauh lebih lancar.

Kuis singkat

Kuis singkat

1. Tool apa yang menginstal compiler Rust dan cargo, sekaligus menjaganya tetap ter-update?

rustup cargo rustc

2. File mana yang menjelaskan nama, versi, dan dependensi sebuah proyek Rust?

src/main.rs target/debug/ Cargo.toml

3. Perintah mana yang hanya meng-compile programmu tanpa menjalankannya?

cargo run cargo build cargo new

Skor: 0 / 3

Bacaan lebih lanjut

• Installation — The Rust Book (bahasa Inggris): cara instal di semua platform, update dengan rustup update, dan mengatasi masalah.
• Hello, Cargo! — The Rust Book (bahasa Inggris): penjelasan lebih dalam tentang cargo new, cargo build, cargo run, dan cargo check.
• First Steps with Cargo — The Cargo Book (bahasa Inggris): apa saja yang dibuat oleh cargo new dan arti setiap baris di Cargo.toml.
• The rustup book (bahasa Inggris): menginstal toolchain tambahan, meng-update Rust, dan berpindah antara versi stable dan nightly.
• rust-analyzer (bahasa Inggris): panduan setup untuk VS Code, Neovim, Emacs, dan editor lainnya.