全部产品
Search
文档中心

AI Coding Assistant Lingma:Pengecualian Eksekusi Terminal

更新时间:Jul 06, 2025

Pendahuluan

Lingkungan pengembangan dan konfigurasi dapat memengaruhi eksekusi perintah di terminal. VS Code dan IDE JetBrains memiliki beberapa batasan dan masalah kompatibilitas dengan terminal pada sistem operasi yang berbeda. Hal ini dapat menyebabkan masalah seperti tidak bisa memanggil perintah terminal atau mendapatkan hasil saat menggunakan mode Lingma Agent.

VS Code

Metode pemecahan masalah umum

Plugin Lingma di VS Code bergantung pada API Integrasi Shell VS Code untuk mengeksekusi perintah terminal dan membaca output mereka. API ini adalah fitur baru di versi 1.93 VS Code dan saat ini hanya mendukung jenis shell berikut:

Pastikan versi VS Code Anda lebih besar dari 1.93 dan bahwa terminal default Anda adalah salah satu dari berikut:

  • Linux/macOS: bash, fish, pwsh, zsh

  • Windows: Git Bash, pwsh

Jika Anda mengalami pengecualian eksekusi terminal, coba metode berikut:

Metode 1: Tingkatkan VS Code

Periksa versi VS Code Anda dan pastikan itu 1.93 atau lebih tinggi:

  1. Buka VS Code.

  2. Tekan Cmd + Shift + P (Mac) atau Ctrl + Shift + P (Windows/Linux).

  3. Ketik Code: Check for Updates, lalu pilih opsi tersebut.

  4. Mulai ulang VS Code setelah pembaruan selesai.

Metode 2: Konfigurasikan shell VS Code yang didukung

  1. Buka VS Code.

  2. Tekan Cmd + Shift + P (Mac) atau Ctrl + Shift + P (Windows/Linux).

  3. Ketik Terminal: Select Default Profile, lalu pilih opsi tersebut.

  4. Pilih shell yang didukung:

    • Linux/macOS: bash, fish, pwsh, zsh

    • Windows: Git Bash, pwsh

  5. Keluar dari VS Code, lalu buka kembali.

Metode 3: Instal manual integrasi shell

Jika Anda masih mengalami masalah dengan langkah-langkah di atas, instal manual integrasi shell.

Sebagai contoh,

  • zsh:

    1. Tambahkan baris berikut ke file ~/.zshrc Anda:

      [[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)"
    2. Simpan file tersebut.

    3. Keluar dari VS Code, lalu buka kembali.

  • Bash (~/.bashrc):

[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
  • PowerShell ($Profile):

if ($env:TERM_PROGRAM -eq "vscode") { . "$(code --locate-shell-integration-path pwsh)" }
  • Fish (~/.config/fish/config.fish):

string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish)

Masih mengalami masalah?

Jika Anda masih tidak bisa mendapatkan output terminal setelah mencoba metode di atas, klik Stop Terminal untuk menutup jendela terminal. Kemudian, jalankan perintah lagi. Ini akan mereset koneksi terminal dan seharusnya memperbaiki masalah tersebut.

Windows

Git Bash

Git Bash memberikan pengalaman baris perintah mirip Unix di Windows. Untuk menggunakan Git Bash, Anda perlu:

  1. Unduh dan jalankan installer Git for Windows dari https://git-scm.com/downloads/win.

  2. Keluar dan buka kembali VS Code.

  3. Tekan Ctrl + Shift + P untuk membuka palet perintah.

  4. Ketik Terminal: Select Default Profile, kemudian pilih.

  5. Pilih Git Bash.

PowerShell

Pastikan versi PowerShell Anda diperbarui ke versi setelah 7.

  • Periksa versi PowerShell Anda saat ini dengan menjalankan perintah: $PSVersionTable.PSVersion

  • Jika versi Anda lebih rendah dari 7, perbarui PowerShell.

Secara default, PowerShell membatasi eksekusi skrip karena alasan keamanan. Untuk mengubah pengaturan:

  1. Buka PowerShell sebagai administrator: Tekan Win + X dan pilih Windows PowerShell (Administrator) atau Windows Terminal (Administrator).

  2. Periksa kebijakan eksekusi saat ini dengan menjalankan perintah:

    Get-ExecutionPolicy
    • Jika output sudah RemoteSigned, Unrestricted, atau Bypass, Anda mungkin tidak perlu mengubah kebijakan eksekusi. Kebijakan ini seharusnya memungkinkan integrasi shell bekerja dengan baik.

    • Jika output adalah Restricted atau AllSigned, ubah kebijakan untuk mengaktifkan integrasi shell.

  3. Ubah kebijakan eksekusi dengan menjalankan perintah:

    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

    Ini akan mengatur kebijakan RemoteSigned hanya untuk pengguna saat ini, yang lebih aman daripada perubahan di seluruh sistem.

  4. Konfirmasi perubahan: Ketik Y di prompt dan tekan Enter.

  5. Verifikasi perubahan kebijakan: Jalankan Get-ExecutionPolicy lagi untuk memastikan pengaturan baru.

  6. Mulai ulang VS Code dan coba integrasi shell lagi.

WSL

Jika Anda menggunakan WSL, coba tambahkan . "$(code --locate-shell-integration-path bash)" ke file ~/.bashrc Anda, lalu mulai ulang dan coba lagi.

Pengecualian lainnya

Pengecualian output terminal

Jika Anda melihat output abnormal dengan persegi panjang, garis, urutan escape, atau karakter kontrol, hal itu mungkin terkait dengan alat penyesuaian terminal. Penyebab umum termasuk tema zsh seperti: Powerlevel10k, Oh My Zsh, fish shell, dll.

Cara Pemecahan Masalah:

  1. Sementara nonaktifkan alat-alat ini di file konfigurasi shell Anda (misalnya, file ~/.zshrc untuk zsh).

  2. Jika masalah teratasi, aktifkan kembali fitur secara bertahap untuk mengidentifikasi alat yang bertentangan.

Sebagai contoh, jika Anda menggunakan Powerlevel10k di zsh, nonaktifkan dengan mengomentari baris terkait di file ~/.zshrc Anda:

# Komentari baris sumber untuk Powerlevel10k
# source /path/to/powerlevel10k/powerlevel10k.zsh-theme

Jika masalah dapat diperbaiki dengan menonaktifkan tema-tema ini, Anda mungkin perlu menemukan konfigurasi integrasi shell VS Code lainnya.

IDE JetBrains

Plugin Lingma saat ini tidak mendukung terminal baru (Beta) yang tersedia di UI baru mulai versi 2024.1 IDE.

image.png

Untuk menonaktifkan terminal baru:

  • Metode 1: Di Settings atau Preferences, buka Tools - Terminal - Aktifkan Terminal Baru dan hapus centang opsi terminal baru.

  • Metode 2: Di judul jendela Terminal, klik ikon image.svg dan hapus centang Enable New Terminal.

Hubungi kami

Hubungi kami jika Anda masih tidak bisa menyelesaikan masalah Anda setelah memeriksa solusi dalam dokumen ini.