跳转到主要内容

​
简介

在使用 Qoder 智能体模式时，终端执行高度依赖于你的本地环境和 shell 配置。你可能会遇到以下问题：
  • 无法启动终端
  • 命令无法执行
  • 没有任何输出
本主题提供常见的排查方法，帮助解决这些问题。

​
常见故障排查方法

​
方法 1：配置受支持的 shell

Qoder 支持多种 shell。请确保你使用的是兼容的 shell。
  1. 打开 Qoder。
  2. 按下 Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows/Linux）打开命令面板（Command Palette）。
  3. 输入 Terminal: Select Default Profile 并选择该项。
  4. 选择一个受支持的 shell：
    • Linux/macOS：bash、fish、pwsh、zsh
    • Windows：Git Bash、pwsh
  5. 完全关闭并重新打开 Qoder 以使更改生效。

​
方法 2：手动安装 shell 集成

如果终端集成仍然失败，请通过在 shell 的配置文件中添加相应语句来手动安装 shell 集成。
  • zsh（~/.zshrc）：
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)"
  • Bash（~/.bashrc）：
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
  • PowerShell（$Profile）：
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
  • Fish（~/.config/fish/config.fish）：
string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish)
在编辑该文件后：
  1. 保存更改。
  2. 完全重启 Qoder。
针对其他 shell，请参阅手动 shell 集成。

​
如果问题仍然存在

如果你仍然看不到终端输出：
  • 点击“Terminate Terminal”按钮以关闭当前终端会话。
  • 重新运行该命令。这会刷新终端连接，通常能解决临时性问题。

​
Windows 专属故障排除

​
Git Bash

  1. 从 https://git-scm.com/downloads/win 下载并安装 Windows 版 Git。
  2. 退出并重新打开 Qoder。
  3. 将“Git Bash”设为默认终端： a. 打开命令面板（Command Palette）。 b. 运行：Terminal: Select Default Profile。 c. 选择 Git Bash。

​
PowerShell

  1. 请确保使用 PowerShell 7 或更高版本。
    查看当前版本：
$PSVersionTable.PSVersion
  1. 如有需要，请更新 PowerShell。
  2. 默认情况下，出于安全考虑，PowerShell 会限制脚本执行。您可能需要调整执行策略。
a. 以管理员身份打开 PowerShell：
  • 按下 Win + X
  • 选择 Windows PowerShell（管理员）或 Windows Terminal（管理员）
b. 检查当前策略： 
Get-ExecutionPolicy

# 如果输出是 RemoteSigned、Unrestricted 或 Bypass，您可能不需要更改执行策略。这些设置应该允许 shell 集成正常工作。
# 如果输出是 Restricted 或 AllSigned，您可能需要更改策略以启用 shell 集成。
c. 为你的用户更新策略： 
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 这将仅为当前用户设置 RemoteSigned 策略，比系统级更改更安全。
d. 在出现提示时按 Y 确认，然后验证： 
Get-ExecutionPolicy
e. 重启 Qoder 后重试。

​
WSL

如果使用 Windows Subsystem for Linux（WSL）：
  1. 在你的 ~/.bashrc 中添加以下一行：
. "$(code --locate-shell-integration-path bash)"
2. 重新加载你的 shell，或运行 source ~/.bashrc。 3. 在 Qoder 中再次尝试该终端命令。

​
其他常见问题

​
异常终端输出

如果你看到：
  • 乱码
  • 方块符号
  • 转义序列（例如：^[[1m、^[[32m）
  • 控制码
这通常是由第三方 shell 个性化配置引起的，例如：
  • Powerlevel10k
  • Oh My Zsh
  • 自定义的 fish 主题
解决方案
  1. 在你的 shell 配置文件中暂时禁用这些个性化配置。
例如，在 ~/.zshrc 中，将与 Powerlevel10k 相关的那一行注释掉： 
# source /path/to/powerlevel10k/powerlevel10k.zsh-theme
  1. 重启 Qoder 并进行测试。
  2. 如果问题已解决，请逐项重新启用自定义设置，以定位发生冲突的组件。
  3. 为长期使用，请选择与 Qoder 终端集成兼容的配置。
⌘I