Penyiapan

Memasang Odin, perintah odin, dan konfigurasi editor.

Daftar isi

Topik ini menuntun penyiapan lingkungan kerja Odin dari nol, yaitu pemasangan compiler, verifikasi instalasi, program hellope pertama, perintah inti odin, dan penyambungan editor dengan language server OLS. Langkah unduh dan pasang disajikan sebagai daftar yang dijalankan di mesin pembaca, sedangkan setiap perintah yang dapat dieksekusi di lingkungan jalur ini disertai keluaran aslinya. Setelah seluruh langkah selesai, kompilasi dan eksekusi program Odin dapat dilakukan sepenuhnya dari terminal.

Memasang compiler Odin#

Cara tercepat memasang Odin adalah mengunduh rilis pra-kompilasi (prebuilt release) resmi, yaitu arsip siap pakai yang tidak memerlukan proses build sama sekali. Halaman install odin-lang.org mengumpulkan tautan unduhannya, sedangkan arsip per rilis tersedia pada halaman releases GitHub, misalnya arsip odin-linux-amd64-dev-2026-10.tar.gz untuk Linux AMD64. Arsip semacam ini memuat binari compiler beserta folder pustakanya dalam satu paket, sehingga pemasangannya berupa ekstraksi dan pendaftaran path.

Pada Linux, pemasangan mengikuti urutan berikut.

  1. Unduh arsip rilis yang sesuai arsitektur, misalnya odin-linux-amd64-dev-2026-10.tar.gz untuk mesin AMD64.
  2. Ekstrak arsipnya ke folder permanen karena compiler membaca folder pustaka yang berdampingan dengannya.
  3. Pasang clang melalui apt install clang pada Debian dan Ubuntu atau dnf install clang pada Fedora, karena clang menjadi linker Odin pada Linux.
  4. Daftarkan folder hasil ekstraksi ke PATH agar perintah odin dapat dipanggil dari folder mana pun.
bash
# tidak-dijalankan
# langkah pemasangan pada Linux AMD64, dijalankan di mesin pembaca
wget https://github.com/odin-lang/Odin/releases/download/dev-2026-10/odin-linux-amd64-dev-2026-10.tar.gz
tar -xzf odin-linux-amd64-dev-2026-10.tar.gz
sudo apt install clang
echo 'export PATH="$HOME/tools/odin:$PATH"' >> ~/.bashrc

Pada macOS, jalur pemasangannya dapat berupa unduhan arsip langsung atau package manager Homebrew dengan perintah brew install odin. Paket dari package manager disiapkan pihak ketiga, sehingga versi yang didapat bisa tertinggal dari rilis resmi terbaru. Pada Windows, compiler memerlukan komponen Desktop development with C++ dari Visual Studio Build Tools karena MSVC menjadi linker di sana, sebagaimana dirinci pada halaman install resmi.

bash
# tidak-dijalankan
# pemasangan lewat Homebrew pada macOS, dijalankan di mesin pembaca
brew install odin

Memverifikasi instalasi#

Instalasi yang sah diverifikasi dengan dua perintah, yaitu odin version dan odin root. Perintah pertama menampilkan lini rilis compiler, sedangkan perintah kedua menampilkan lokasi pemasangan compiler beserta folder pustakanya. Keluaran keduanya pada lingkungan jalur ini tampak seperti berikut.

bash
odin version
text Keluaran
odin version dev-2026-10-nightly:84bc3fc
bash
odin root
text Keluaran
/home/kal/my-project/tools/odin/

Path pada keluaran odin root di atas adalah lokasi pemasangan pada lingkungan jalur ini. Pada mesin lain, nilainya mengikuti folder tempat compiler diekstraksi, misalnya /usr/local/odin atau folder pemasangan Homebrew. Yang perlu dipastikan adalah nilainya menunjuk folder yang memuat folder base, core, dan vendor, karena compiler membaca ketiganya dari lokasi tersebut.

Program hellope pertama#

Dokumentasi resmi Odin menggunakan program hellope sebagai program pertama, dan jalur ini mengikuti tradisi yang sama. Program mendeklarasikan package main, mengimpor core:fmt untuk pencetakan terformat, lalu mencetak satu baris teks dari proc main. Proc main adalah titik masuk program yang dikompilasi sebagai aplikasi.

odin hellope.odin
package main

import "core:fmt"

main :: proc() {
	fmt.println("Hellope!")
}
bash
# jalankan program dari direktori topik
odin run hellope.odin -file
text Keluaran
Hellope!

Opsi -file memberitahu compiler bahwa sumbernya adalah satu berkas dan bukan folder package. Perintah odin run mengompilasi program lalu langsung menjalankannya, sehingga satu perintah mencakup dua langkah. Program yang sama pada macOS dan Windows menghasilkan keluaran yang sama karena pencetakan teks tidak bergantung pada platform.

Perintah inti odin#

Perintah odin adalah kendali utama seluruh pekerjaan, dan enam subperintah berikut mencakup tugas harian jalur ini.

PerintahFungsi
odin run .Mengompilasi lalu langsung menjalankan program dari folder package
odin build .Mengompilasi program menjadi binari tanpa menjalankannya
odin check .Memeriksa sintaks dan tipe tanpa menghasilkan binari
odin test .Menjalankan proc bertanda @(test) dalam package
odin versionMenampilkan versi compiler
odin rootMenampilkan lokasi pemasangan compiler dan pustakanya

Urutan berikut memperlihatkan tiga perintah pertama bekerja pada program hellope yang sama. odin check dan odin build tidak mencetak apa pun ketika berhasil, sehingga satu-satunya keluaran berasal dari binari hellope.

bash
# periksa program tanpa menghasilkan binari
odin check hellope.odin -file
# kompilasi menjadi binari bernama hellope
odin build hellope.odin -file -out:hellope
# jalankan binari hasil kompilasi
./hellope
text Keluaran
Hellope!

Dua perintah itu hanya menampilkan pesan ketika terjadi error, misalnya kesalahan tipe atau nama yang tidak dikenal, dan pesannya menyebut baris beserta kolomnya. Kebiasaan menjalankan odin check setiap kali menyunting menghemat waktu karena pemeriksaan statis melewati tahap codegen dan linking.

Editor dengan language server OLS#

Penyuntingan Odin bertumpu pada OLS, yaitu language server untuk Odin yang dikembangkan secara terbuka di GitHub. OLS menyediakan pelengkapan kode, go to definition, semantic tokens, document symbols, rename, references, signature help, dan hover. Konfigurasinya dibaca dari berkas ols.json pada akar workspace, misalnya untuk mendeklarasikan collection tambahan di luar core dan vendor.

Tiga editor berikut adalah pilihan yang dapat disambungkan ke OLS.

EditorCara menyambungkan OLS
VS CodeEkstensi OLS (DanielGavin.ols) dari marketplace
NeovimKlien LSP bawaan dengan plugin nvim-lspconfig
ZedEkstensi Odin dari toko ekstensi Zed

Pemformatan diserahkan ke odinfmt, yaitu formatter yang dibundel bersama OLS, sehingga tata letak kode mengikuti satu gaya kanonik. Setelah OLS berjalan, kesalahan tipe muncul di editor tanpa perintah tambahan, dan navigasi menuju definisi proc pustaka bekerja dari core maupun folder proyek. Konfigurasi per editor dirinci pada README OLS, dan tiga pilihan di atas cukup untuk mengikuti seluruh jalur ini.

Ringkasan#

  • Odin dipasang paling cepat dari rilis pra-kompilasi resmi, dengan clang sebagai linker pada Linux dan MSVC pada Windows, sedangkan pada macOS, Odin juga tersedia melalui Homebrew.
  • Instalasi diverifikasi dengan odin version dan odin root, dan binari compiler harus berdampingan dengan folder base, core, serta vendor.
  • Program hellope dijalankan dengan odin run hellope.odin -file, sedangkan build, check, dan test mengatur kompilasi, pemeriksaan statis, dan pengujian.
  • Editor disambungkan ke OLS untuk pelengkapan, navigasi, rename, dan pemformatan yang konsisten.

Referensi#