AI Coding Assistant Lingma：終端執行異常說明

方法 1：升級 VSCode

請檢查您使用的 VSCode 版本，保證是 1.93 及以上：

1. 開啟 VSCode；

2. 按下 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Windows/Linux）；

3. 輸入 Code: Check for Updates，然後選擇它；

4. 更新完成後重新啟動 VSCode。

方法 2：配置 VSCode 支援的 Shell

1. 開啟 VSCode；

2. 按下 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Windows/Linux）；

3. 輸入 Terminal: Select Default Profile，然後選擇它；

4. 選擇一個受支援的 Shell：

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

   • Windows: Git Bash, pwsh

5. 完全退出 VSCode，然後重新開啟 VSCode。

方法 3：手動安裝 Shell 整合

如果在嘗試上述排錯步驟後仍然遇到問題，您可以嘗試手動安裝 Shell 整合。

例如，如果您使用 zsh：

1. 將以下行添加到您的 ~/.zshrc 檔案中：

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

2. 儲存檔案；

3. 完全退出 VSCode，然後重新開啟 VSCode。

   如果您使用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)

如果您使用其他類型的 Shell，可參考文檔：手動安裝 Shell 整合。

Git Bash

您可以嘗試使用 Git Bash。Git Bash 可以在 Windows 上提供類似 Unix 的命令列體驗，如需使用 Git Bash，您需要：

1. 從 https://git-scm.com/downloads/win 下載並運行 Git for Windows 安裝程式；

2. 退出並重新開啟 VSCode；

3. 按下 Ctrl + Shift + P 開啟命令選擇區；

4. 輸入 Terminal: Select Default Profile，然後選擇它；

5. 選擇“Git Bash”。

PowerShell

如果您仍然希望使用 PowerShell，請確保您使用的是更新後的版本（至少 v7+）。

• 通過運行以下命令檢查當前的 PowerShell 版本：$PSVersionTable.PSVersion

• 如果您的版本低於 7，請更新 PowerShell。

預設情況下，出於安全原因，PowerShell 限制指令碼的執行。您可能還需要調整 PowerShell 的執行策略：

1. 以管理員身份開啟 PowerShell：按下 Win + X 並選擇“Windows PowerShell（管理員）”或“Windows 終端（管理員）”；

2. 通過運行以下命令檢查當前的執行策略：

   Get-ExecutionPolicy

   • 如果輸出已經是 RemoteSigned、Unrestricted 或 Bypass，則您可能不需要更改執行策略。這些策略應允許 Shell 整合正常工作；

   • 如果輸出是 Restricted 或 AllSigned，則您可能需要更改策略以啟用 Shell 整合。

3. 通過運行以下命令更改執行策略：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

   這將僅為目前使用者設定 RemoteSigned 策略，這比系統範圍更改更安全。

4. 確認更改：在提示時輸入 Y 並按 Enter 鍵；

5. 驗證策略更改：再次運行 Get-ExecutionPolicy 以確認新的設定；

6. 重新啟動 VSCode 並再次嘗試 Shell 整合。

WSL

如果您使用 WSL，嘗試添加 . "$(code --locate-shell-integration-path bash)" 到你的 ~/.bashrc，然後重啟後重試。

終端輸出異常

如果您看到帶有矩形、線條、逸出序列或控制字元的異常輸出，這可能與終端自訂工具有關。常見的罪魁禍首包括：Powerlevel10k（一種為提示符添加視覺元素的 zsh 主題）、Oh My Zsh、Fish shell 主題等。

如何排錯：

1. 在您的 Shell 設定檔中臨時禁用這些工具（例如，Zsh 的 ~/.zshrc 檔案）；

2. 如果問題解決，逐步重新啟用功能以識別衝突的工具

例如，如果您在 Zsh 中使用 Powerlevel10k，可以通過注釋掉 ~/.zshrc 檔案中的相關行來禁用它：

# 注釋掉 Powerlevel10k 的原始碼行
# source /path/to/powerlevel10k/powerlevel10k.zsh-theme

如果禁用這些自訂解決了問題，您可能需要找到與 VSCode Shell 整合功能相容的替代配置。