终端执行异常说明

方法 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 集成功能兼容的替代配置。