Cara Mengatasi Masalah Tampilan Karakter (Mojibake) di Ubuntu: Panduan Lengkap

1. Pendahuluan

Saat menggunakan Ubuntu, terkadang terjadi **masalah tampilan karakter (mojibake)** dalam situasi tertentu. Misalnya, output di terminal, tampilan nama file berbahasa Jepang, atau saat menjelajahi halaman berbahasa Jepang di browser, gejalanya bervariasi tergantung pada lingkungan. Terutama, seringkali bahasa Jepang tidak ditampilkan dengan benar jika pengaturan default dibiarkan, sehingga diperlukan konfigurasi yang tepat.

Artikel ini menjelaskan penyebab masalah tampilan karakter yang terjadi di Ubuntu dan metode spesifik untuk mengatasinya. Pembaca yang dituju adalah sebagai berikut:

• Pengguna Ubuntu pemula yang belum melakukan pengaturan tampilan bahasa Jepang
• Mereka yang ingin mengetahui penyebab masalah tampilan karakter dan mencari solusi mendasar
• Mereka yang mengalami masalah tampilan karakter di terminal atau lingkungan GUI dan ingin mengetahui cara mengatasinya

Mari kita lihat penyebab utama masalah tampilan karakter di Ubuntu.

2. Penyebab Utama Masalah Tampilan Karakter

Kesalahan Pengaturan Lokal (Locale)

**Locale** di Ubuntu adalah pengaturan lingkungan yang menentukan bahasa dan format tanggal sistem. Jika ini tidak diatur dengan benar, bahasa Jepang mungkin tidak ditampilkan atau masalah tampilan karakter dapat terjadi.

Misalnya, jika Anda menjalankan perintah locale dan hasilnya menunjukkan “C” atau “POSIX” seperti di bawah ini, ada kemungkinan locale tidak diatur dengan benar:

$ locale
LANG=C
LC_ALL=

Seharusnya, untuk lingkungan bahasa Jepang, lebih baik jika terlihat seperti LANG=ja_JP.UTF-8.

Font Tidak Terinstal atau Tidak Lengkap

Dalam kondisi default Ubuntu, font bahasa Jepang mungkin tidak terinstal. Akibatnya, teks berbahasa Jepang tidak ditampilkan dengan benar, dan kotak kosong (□) atau simbol tidak dikenal dapat muncul.

Secara khusus, kekurangan font dapat terlihat dalam situasi berikut:

• Menu atau tombol aplikasi GUI menampilkan masalah karakter
• Teks editor menampilkan masalah karakter saat membuka file bahasa Jepang

Ketidaksesuaian Pengkodean Karakter (Character Encoding)

Ubuntu secara standar menggunakan UTF-8, tetapi jika Anda membuka file dengan pengkodean karakter yang berbeda dari sumber eksternal seperti Shift_JIS atau EUC-JP, masalah tampilan karakter dapat terjadi.

Misalnya, saat membuka file yang dibuat di lingkungan Windows di Ubuntu, fenomena berikut dapat terjadi:

• Saat dibuka dengan editor teks, simbol tidak dikenal ditampilkan
• Saat menjalankan perintah cat di terminal, karakter menjadi kacau

Kesalahan Pengaturan Terminal atau Editor

Jika terminal atau editor tidak diatur dengan benar, file yang dienkode dengan UTF-8 pun mungkin tidak ditampilkan dengan benar.

• Pengaturan encoding terminal bukan UTF-8
• Pengenalan otomatis pengkodean karakter tidak berfungsi di editor seperti Vim atau VSCode
• Saat ditampilkan dengan less atau cat, bagian bahasa Jepang hanya menunjukkan “?” atau “◇”

3. Memeriksa dan Memperbaiki Pengaturan Lokal (Locale)

Cara Memeriksa Pengaturan Lokal

Pertama, untuk memeriksa pengaturan locale saat ini, jalankan perintah berikut:

locale

Contoh output:

LANG=C
LC_CTYPE="C"
LC_NUMERIC="C"
LC_TIME="C"
LC_COLLATE="C"
LC_MONETARY="C"
LC_MESSAGES="C"
LC_PAPER="C"
LC_NAME="C"
LC_ADDRESS="C"
LC_TELEPHONE="C"
LC_MEASUREMENT="C"
LC_IDENTIFICATION="C"
LC_ALL=

Dalam kasus ini, LANG=C menunjukkan bahwa lingkungan bahasa Jepang tidak diatur dengan benar. Untuk lingkungan bahasa Jepang, diharapkan hasilnya adalah sebagai berikut:

LANG=ja_JP.UTF-8
LC_ALL=ja_JP.UTF-8

Menginstal dan Mengatur Locale Bahasa Jepang

1. Memeriksa dan Menambahkan Locale Bahasa Jepang

Untuk memeriksa apakah locale bahasa Jepang sudah terinstal di sistem, jalankan perintah berikut:

locale -a | grep ja_JP

Contoh output:

ja_JP.eucJP
ja_JP.utf8

Jika ja_JP.utf8 tidak muncul dalam daftar, Anda perlu menginstal locale bahasa Jepang.

Jalankan perintah berikut untuk menambahkan locale bahasa Jepang:

sudo apt update
sudo apt install -y language-pack-ja

Selanjutnya, untuk mengaktifkan locale, jalankan perintah berikut:

sudo locale-gen ja_JP.UTF-8
sudo update-locale LANG=ja_JP.UTF-8

2. Mengatur Locale Sistem

Untuk menerapkan perubahan locale ke seluruh sistem, jalankan perintah berikut:

export LANG=ja_JP.UTF-8
export LC_ALL=ja_JP.UTF-8

Untuk membuat pengaturan ini permanen, tambahkan ke ~/.bashrc atau ~/.profile:

echo 'export LANG=ja_JP.UTF-8' >> ~/.bashrc
echo 'export LC_ALL=ja_JP.UTF-8' >> ~/.bashrc
source ~/.bashrc

Atau, jika Anda ingin menerapkan untuk semua pengguna, edit file berikut:

sudo nano /etc/default/locale

Tambahkan atau ubah konten berikut:

LANG=ja_JP.UTF-8
LC_ALL=ja_JP.UTF-8

Untuk menerapkan pengaturan, log out lalu login kembali, atau reboot sistem.

4. Instalasi dan Pengaturan Font

Pentingnya Font Bahasa Jepang

Dalam kondisi default Ubuntu, font bahasa Jepang mungkin tidak terinstal. Akibatnya, teks berbahasa Jepang tidak ditampilkan dengan benar, dan kotak kosong (□) atau simbol tidak dikenal dapat muncul.

Secara khusus, kekurangan font dapat terlihat dalam situasi berikut:

• Menu atau tombol aplikasi GUI menampilkan masalah karakter
• Teks editor menampilkan masalah karakter saat membuka file bahasa Jepang

Font Bahasa Jepang yang Direkomendasikan

Berikut adalah beberapa font bahasa Jepang yang dapat digunakan di Ubuntu:

Cara Menginstal Font

1. Noto Sans CJK JP (Font yang Direkomendasikan Default)

sudo apt update
sudo apt install -y fonts-noto-cjk

2. Takao Font

sudo apt install -y fonts-takao

3. IPA Font (Information-technology Promotion Agency)

sudo apt install -y fonts-ipafont

4. VL Gothic (Untuk Terminal)

sudo apt install -y fonts-vlgothic

Setelah instalasi selesai, reboot sistem atau perbarui cache font untuk menerapkan pengaturan.

fc-cache -fv

Cara Mengatur Font

Pengaturan Font di Aplikasi GUI

1. Buka aplikasi “Pengaturan” (Settings)
2. Buka bagian “Font”
3. Ubah “Font Standar” (Standard Font), “Font Dokumen” (Document Font), dan “Font Lebar Tetap” (Monospace Font) ke font pilihan Anda
4. Log out dan log in kembali untuk menerapkan pengaturan

Pengaturan Font di Terminal

1. Buka Terminal
2. Pilih “Preferensi” (Preferences) → “Edit Profil” (Edit Profile) dari menu
3. Centang “Gunakan font khusus” (Use custom font) di bagian “Font”
4. Pilih font pilihan Anda (misalnya: Noto Sans Mono CJK JP)
5. Simpan pengaturan dan restart Terminal

Menerapkan dan Memeriksa Pengaturan

Untuk memeriksa apakah pengaturan font telah diterapkan dengan benar, coba metode berikut:

1. Periksa font yang terinstal dengan perintah fc-list

fc-list | grep "Noto"

2. Periksa tampilan bahasa Jepang di terminal

echo "こんにちは、Ubuntuの文字化け対策"

3. Periksa apakah bahasa Jepang ditampilkan dengan benar di aplikasi GUI (Firefox, LibreOffice, dll.)

5. Memeriksa dan Mengonversi Pengkodean Karakter

Apa Itu Pengkodean Karakter?

Pengkodean karakter adalah aturan untuk menangani karakter sebagai data digital. Beberapa pengkodean karakter yang umum adalah sebagai berikut:

Ubuntu secara standar menggunakan **UTF-8**, jadi jika Anda membuka file yang disimpan dengan pengkodean karakter selain itu, masalah tampilan karakter dapat terjadi.

Cara Memeriksa Pengkodean Karakter File

1. Menggunakan Perintah file

file -i sample.txt

Contoh output:

sample.txt: text/plain; charset=iso-8859-1

2. Menggunakan Perintah nkf

sudo apt install -y nkf
nkf --guess sample.txt

Contoh output:

Shift_JIS (CRLF)

Cara Mengonversi Pengkodean Karakter

1. Menggunakan Perintah iconv

Contoh konversi Shift_JIS → UTF-8:

iconv -f SHIFT_JIS -t UTF-8 sample.txt -o sample_utf8.txt

Contoh konversi EUC-JP → UTF-8:

iconv -f EUC-JP -t UTF-8 sample.txt -o sample_utf8.txt

2. Menggunakan Perintah nkf

Contoh konversi Shift_JIS → UTF-8:

nkf -w sample.txt > sample_utf8.txt

Contoh konversi EUC-JP → UTF-8:

nkf -w --overwrite sample.txt

Penanganan Masalah Tampilan Karakter di Terminal atau Editor

1. Menampilkan dengan Benar Menggunakan Perintah less

export LESSCHARSET=utf-8
less sample.txt

2. Membuka dengan vim dengan Menentukan Pengkodean Karakter

vim -c "set encoding=utf-8" sample.txt

3. Mengubah Pengkodean Karakter di gedit atau VSCode

• gedit (Editor standar GNOME)

1. Buka file dengan gedit sample.txt
2. Saat “Simpan Sebagai” (Save As), ubah “Encoding” menjadi UTF-8

• VSCode (Visual Studio Code)

1. Klik “Encoding” di bagian bawah layar
2. Konversi ke UTF-8

6. Memeriksa Pengaturan Terminal dan Editor

Memeriksa dan Memperbaiki Pengaturan Terminal

1. Memeriksa Pengaturan Encoding Terminal

Untuk memeriksa variabel lingkungan saat ini, jalankan perintah berikut:

echo $LANG
echo $LC_ALL

Contoh output (jika diatur dengan benar)

ja_JP.UTF-8
ja_JP.UTF-8

Jika hasilnya adalah C atau POSIX, Anda perlu mengubahnya ke locale yang sesuai (ja_JP.UTF-8).

2. Pengaturan Font Terminal

GNOME Terminal (Terminal Default)

1. Buka Terminal
2. Buka **”Preferensi”** (Preferences) dari menu
3. Buka tab “Profil” (Profile) → “Teks” (Text)
4. Aktifkan “Gunakan font kustom” (Use custom font) dan pilih salah satu dari berikut ini:

• Noto Sans Mono CJK JP
• VL Gothic
• Takao Gothic

1. Simpan pengaturan dan restart Terminal

Pengaturan Pengkodean Karakter Editor Teks

1. Pengaturan Pengkodean Karakter Vim

Untuk memeriksa pengaturan saat ini, buka Vim dan jalankan perintah berikut:

:set encoding?
:set fileencoding?

Contoh output:

encoding=utf-8
fileencoding=utf-8

Jika bukan utf-8, tambahkan baris berikut ke file konfigurasi Vim (~/.vimrc) untuk mengubah default ke UTF-8:

set encoding=utf-8
set fileencodings=utf-8,sjis,euc-jp
set fileformats=unix,dos,mac

2. Pengaturan Pengkodean Karakter Nano

Jika Anda ingin mengubah pengaturan default, tambahkan baris berikut ke file konfigurasi (~/.nanorc):

set encoding "utf-8"

3. Pengaturan Pengkodean Karakter VSCode (Visual Studio Code)

1. Klik **”Encoding”** di sudut kanan bawah layar editor
2. Pilih UTF-8 dari **”Change Encoding”**
3. Jika perlu, jalankan **”Save with Encoding”**

Selain itu, untuk mengatur default ke UTF-8, tambahkan baris berikut ke **file pengaturan (settings.json)**:

"files.encoding": "utf8"

7. Solusi Berdasarkan Kasus

Penanganan Masalah Tampilan Karakter di Aplikasi GUI

1. Tampilan Bahasa Jepang Rusak di Firefox atau Chrome

Solusi:

1. Instal font yang diperlukan

sudo apt install -y fonts-noto-cjk fonts-ipafont

2. Periksa pengaturan font browser

• Firefox:
  1. Akses about:preferences, lalu buka “Font dan Warna” (Fonts & Colors) → “Lanjutan” (Advanced)
  2. Ubah “Proporsional” (Proportional) dan “Monospace” menjadi Noto Sans CJK JP
• Chrome:
  1. Akses chrome://settings/fonts
  2. Ubah “Font standar” (Standard font) dan “Font lebar tetap” (Fixed-width font) menjadi Noto Sans CJK JP

2. Masalah Tampilan Karakter Bahasa Jepang di LibreOffice

Solusi:

1. Instal fonts-noto-cjk dan fonts-ipafont
2. Ubah pengaturan LibreOffice

• “Alat” (Tools) → “Opsi” (Options) → “LibreOffice” → “Font”
• Ubah “Font standar” (Standard font) menjadi Noto Sans CJK JP

Penanganan Masalah Tampilan Karakter di Lingkungan CUI

1. Masalah Tampilan Karakter Saat Koneksi SSH

Solusi:

1. Di sisi server, periksa locale dan pastikan sudah ja_JP.UTF-8

locale

2. Jika bukan ja_JP.UTF-8, jalankan yang berikut ini:

sudo apt install -y language-pack-ja
sudo locale-gen ja_JP.UTF-8
sudo update-locale LANG=ja_JP.UTF-8

Penanganan Masalah Tampilan Karakter di Aplikasi Tertentu

1. Masalah Tampilan Karakter di WSL (Windows Subsystem for Linux)

Solusi:

1. Atur locale WSL ke ja_JP.UTF-8

echo 'export LANG=ja_JP.UTF-8' >> ~/.bashrc
echo 'export LC_ALL=ja_JP.UTF-8' >> ~/.bashrc
source ~/.bashrc

2. Ubah font Windows Terminal ke Noto Sans Mono CJK JP

2. Masalah Tampilan Karakter di Dalam Kontainer Docker

Solusi:

1. Masuk ke kontainer Docker dan periksa locale

docker exec -it container_name bash
locale

2. Tambahkan locale bahasa Jepang

apt update && apt install -y locales
locale-gen ja_JP.UTF-8
export LANG=ja_JP.UTF-8
export LC_ALL=ja_JP.UTF-8

8. FAQ (Pertanyaan yang Sering Diajukan)

Q1. Masalah tampilan karakter saya tidak teratasi meskipun sudah mengatur locale.

A: Jika masalah tampilan karakter tidak teratasi meskipun locale sudah diatur dengan benar, periksa hal berikut:

locale

Jika bukan LANG=ja_JP.UTF-8, pengaturan ulang diperlukan.

sudo update-locale LANG=ja_JP.UTF-8
sudo locale-gen ja_JP.UTF-8
sudo dpkg-reconfigure locales

Q2. Hanya file tertentu yang bermasalah dengan tampilan karakter.

A: Pengkodean karakter mungkin berbeda untuk setiap file. Periksa pengkodean karakter menggunakan metode berikut:

file -i sample.txt

Jika bukan UTF-8, konversi diperlukan.

iconv -f SHIFT_JIS -t UTF-8 sample.txt -o sample_utf8.txt

Atau, jika menggunakan nkf:

nkf -w --overwrite sample.txt

Q3. Saya tidak bisa mengetik bahasa Jepang di terminal.

A: Periksa apakah metode input bahasa Jepang (Fcitx atau IBus) sudah terinstal.

sudo apt update
sudo apt install -y fcitx-mozc
im-config -n fcitx

Q4. Bahasa Jepang bermasalah di WSL (Windows Subsystem for Linux).

A: Atur locale WSL ke ja_JP.UTF-8.

echo 'export LANG=ja_JP.UTF-8' >> ~/.bashrc
echo 'export LC_ALL=ja_JP.UTF-8' >> ~/.bashrc
source ~/.bashrc

Q5. Bahasa Jepang bermasalah di dalam kontainer Docker.

A: Jika locale kontainer Docker adalah C.UTF-8, bahasa Jepang tidak akan ditampilkan dengan benar.

apt update && apt install -y locales
locale-gen ja_JP.UTF-8
export LANG=ja_JP.UTF-8
export LC_ALL=ja_JP.UTF-8

Q6. Menu dan dialog di aplikasi GUI Ubuntu bermasalah dengan tampilan karakter.

A: Instal fonts-noto-cjk dan ubah pengaturan font.

sudo apt install -y fonts-noto-cjk fonts-ipafont

9. Kesimpulan

Dalam artikel ini, kami telah menjelaskan secara rinci **masalah tampilan karakter (mojibake) yang terjadi di Ubuntu**, penyebab, dan cara mengatasinya. Masalah tampilan karakter dapat terjadi karena kesalahan pengaturan locale, font yang tidak terinstal, atau ketidaksesuaian pengkodean karakter, tetapi dapat dicegah dengan konfigurasi yang tepat.

1. Penyebab Utama Masalah Tampilan Karakter

• **Kesalahan pengaturan locale**: Jika bahasa default Ubuntu adalah C atau POSIX, bahasa Jepang tidak akan ditampilkan dengan benar.
• **Font tidak terinstal**: Jika font bahasa Jepang tidak terinstal, masalah tampilan karakter akan terjadi di GUI atau terminal.
• **Ketidaksesuaian pengkodean karakter**: Masalah tampilan karakter akan terjadi saat membuka file dengan pengkodean karakter yang berbeda (seperti Shift_JIS).
• **Kesalahan pengaturan terminal atau editor**: Jika tidak diatur ke UTF-8, tidak akan ditampilkan dengan benar.

2. Cara Mengatasi Masalah Tampilan Karakter

3. Tindakan Tambahan

• **Perbarui sistem secara berkala**: Paket Ubuntu yang sudah usang dapat memengaruhi lingkungan bahasa Jepang.

sudo apt update && sudo apt upgrade -y

• **Permanenkan pengaturan**: Menambahkan perubahan ke ~/.bashrc atau ~/.profile akan memastikan pengaturan diterapkan saat login.
• **Buat cadangan**: Buat cadangan file konfigurasi seperti /etc/default/locale sebelum mengubahnya.

Kesimpulan Akhir

Masalah tampilan karakter yang terjadi di Ubuntu dapat diatasi dengan mengatur empat elemen utama dengan benar: **locale, font, pengkodean karakter, dan pengaturan terminal**. Dengan menerapkan metode yang dijelaskan dalam artikel ini, sebagian besar masalah tampilan karakter dapat dicegah di berbagai lingkungan.