Tanpa Node.js Required

Panduan Lengkap Setup WSL 2 & Multi-Account Git

Dokumentasi rasmi langkah demi langkah untuk membina persekitaran pembangunan Linux (Ubuntu 24.04) di dalam Windows 11/10 dengan pengurusan kunci SSH dan akaun Git berganda yang selamat & automatik.

Senarai Semak Persediaan:

1. Aktif WSL 2. Ubuntu 24 3. VS Code 4. SSH Keys 5. Git Auto

1. Pengenalan WSL 2

Windows Subsystem for Linux (WSL 2) membolehkan anda menjalankan persekitaran Linux sebenar secara penuh di dalam Windows tanpa bebanan *VirtualBox* atau keperluan *dual-boot*.

Petua Penting Prestasi Fail: Sentiasa simpan projek pembangunan anda di dalam sistem fail Linux (contoh: ~/projects/). Jangan simpan kod di dalam folder Windows (/mnt/c/) kerana ia akan memperlahankan operasi Git.

2. Pemasangan WSL & Ubuntu 24.04

Jalankan arahan berikut di dalam PowerShell sebagai Administrator:

PowerShell (Admin)

# 1. Aktifkan Ciri Utama Windows
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 2. Kemas Kini Kernel WSL & Tetapkan WSL 2
wsl --update
wsl --set-default-version 2

# 3. Pasang Ubuntu 24.04 LTS
wsl --install -d Ubuntu-24.04

Selesai Pemasangan: Buka terminal Ubuntu yang baru dipasang, tetapkan UNIX Username dan Password anda. (Teks kata laluan tidak akan kelihatan semasa ditaip).

3. Integrasi VS Code & Kemas Kini Linux

Di dalam terminal Ubuntu yang baru dibuka, jalankan pembersihan pakej dan lancarkan VS Code:

Ubuntu Bash

# Kemas kini repositories & pasang perkakas asas
sudo apt update && sudo apt upgrade -y
sudo apt install build-essential git curl wget -y

# Buka folder Home dalam VS Code
cd ~
code .

Pastikan extension WSL (by Microsoft) telah dipasang di VS Code Windows.
Apabila VS Code terbuka, tekan ikon Extensions dan klik "Install in WSL: Ubuntu-24.04" untuk alat sambungan seperti Gemini/GitLens.

4. Pengurusan Kunci SSH Multi-Account

Sediakan struktur folder yang kemas dan janakan dua kunci SSH berasingan untuk akaun Personal dan Klien:

Terminal Ubuntu

# 1. Cipta Folder Induk Projek
mkdir -p ~/projects/personal
mkdir -p ~/projects/klien

# 2. Jana Kunci SSH Akaun Personal
ssh-keygen -t ed25519 -C "ariffinhamzah88@gmail.com" -f ~/.ssh/id_ed25519_personal

# 3. Jana Kunci SSH Akaun Klien
ssh-keygen -t ed25519 -C "emel-klien@company.com" -f ~/.ssh/id_ed25519_klien

Dapatkan kod awam (.pub) untuk dimasukkan ke GitHub Settings > SSH Keys:

Akaun Personal

cat ~/.ssh/id_ed25519_personal.pub

Akaun Klien

cat ~/.ssh/id_ed25519_klien.pub

Konfigurasikan fail ~/.ssh/config:

~/.ssh/config

# Akaun Personal
Host github.com-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal

# Akaun Klien
Host github.com-klien
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_klien

5. Automasi Identiti Git (Conditional Includes)

Ciri ini secara automatik menukar nama & emel komit Git mengikut folder projek yang anda buka tanpa perlu bertukar secara manual.

~/.gitconfig-personal

[user]
    name = KA
    email = ariffinhamzah88@gmail.com

~/.gitconfig-klien

[user]
    name = Khairul Ariffin Hamzah
    email = emel-klien@company.com

Pautkan dalam fail utama ~/.gitconfig:

~/.gitconfig

[init]
    defaultBranch = develop

[includeIf "gitdir:~/projects/personal/"]
    path = ~/.gitconfig-personal

[includeIf "gitdir:~/projects/klien/"]
    path = ~/.gitconfig-klien

6. Arahan Lazim Developer (Cheat Sheet)

Navigasi & File System

pwd : Tunjuk lokasi folder
ls -la : Senarai fail tersembunyi
explorer.exe . : Buka Windows Explorer
code . : Buka VS Code

Ujian & Clone Git SSH

ssh -T git@github.com-personal
ssh -T git@github.com-klien
git config user.email