Python 无法通过 “Command/Ctrl + 鼠标左键” 跳转到函数定义
语法检测、跳转函数定义等类似的功能是由该语言对应的 Language Server Provider（简称 LSP）提供。以 Python 为例，如遇到了 Python 文件里无法通过快捷键跳转到函数定义，可能的原因有以下几种：
IDE 中未安装 Python 相关的 LSP 插件，如 Python、Pylance、Pyright 等。
Python 相关的 LSP 插件由于某些原因（如仓库过大等）未能加载成功。
受限于插件开发者的服务条款限制，Python 相关的 LSP 插件只能在特定产品中使用，如由 Microsoft 开发的 Python 插件明确提出只能在 VS Code 中使用。
同样以 Python 为例，针对无法跳转到函数定义的问题，可按照以下步骤逐一排查：
进入插件市场，检查是否已安装了 Python 相关的 LSP 插件。
若已安装了由 ms-python 提供的 Python、Pylance 插件，将其卸载。 在 VS Code 中安装 Python 时一般会自动安装 Pylance，所以从 VS Code 或 Cursor 导入配置到 Trae 后，更容易遇到 LSP 不生效的问题。
如无 Python 插件或已将 ms-python 提供的插件卸载干净，请搜索并安装开源社区中 Python 相关的 Language Server，如 BasedPyright。
提示
BasedPyright 默认设置了较为严格的类型检查，为避免被过度干扰，建议将其调低 。步骤如下：
1. 打开 Editor 设置，搜索 pyright type checking mode。
2. 将默认的 recommended 模式修改为 basic 模式。
安装 BasedPyright 后，打开任意 Python 文件，鼠标右击任一一处引用的函数，在出现的菜单中可看到 “转到定义” 等菜单项，即说明 LSP 插件正常可用。
Remote SSH 相关问题
错误码处理：
错误码 错误内容 解决方案
1001 创建目录失败 可能是因为磁盘空间不足或无目录的写入权限。解决方案如下： 检查磁盘剩余空间，确保有足够的空间用于创建目录。 确保有 ~/.trae-cn-server 目录的写入权限。
1002 创建目录失败 同 1001 错误码。
1003 远程主机上启动 Trae CN 服务端失败 检查远程主机的系统版本是否满足要求。
2001 下载安装包失败 检查网络联通性，然后重试。
2002 解压安装包失败 可能是由于安装包的下载过程被截断，导致下载的文件异常，重新安装后再尝试解压。
3001 远程主机上启动 Trae CN 服务端失败 检查远程主机的系统版本是否满足要求。
连接超时问题处理：
连接超时原因 解决方案
服务器未启动，或网络无法连接 在本地终端执行 ssh <host> 测试远程连接： 若连接失败： 检查远程主机的 Trae CN 服务端是否正常运行。 确认网络连接无异常。 若连接成功：继续排查其他潜在问题。
远程主机名称包含大写字母 部分 Trae CN 客户端版本存在兼容性问题：当 ~/.ssh/config 文件中远程主机名称包含大写字母时，可能导致连接超时。解决方案如下： 升级客户端：将 Trae CN 客户端更新至最新版本。 修改主机名：将配置文件中的主机名称全部改为小写字母。
不支持服务器的默认 shell 目前，一些 shell 会导致连接异常，比如 fish。将用户的默认 shell 改成 bash 和 zsh 以解决该问题。
本地 ~/.ssh/config 文件位置变动 如果挪动过本地的 ~/.ssh/config 文件的位置，可能会遇到这个问题。将 ~/.ssh/config 文件放回原先的位置以解决该问题。
若以上解决方案仍无法解决你的问题，可以通过《支持》中提供的渠道联系我们。请在问题反馈中提供以下信息，以便我们尽快定位问题并协助你解决:
IDE 截图（尽量截取完整的 IDE 界面图，以便我们分辨异常信息）。
日志（从输出面板复制 Remote-SSH 相关的完整日志）。
如果是连接超时问题，附上 ssh -vvv <host> 命令的完整输出结果，我们会根据此信息定位超时的原因。
ssh -vvv test
## 此处会输出大量日志，请复制完整的日志
输入过长，导致对话功能异常
与 AI 助手对话时，系统会综合计算以下内容的长度总和，作为输入长度：
输入框中的发送内容
自定义智能体的提示词
自定义智能体所使用的 MCP Server 中包含的所有工具
个人规则和项目规则
当总长度超出限制时，可能会出现：
系统报错导致对话功能异常（如无法发送问题）
问答效果下降
解决方案如下：
精简提问内容、智能体的提示词、MCP Server 中包含的工具数量、以及个人规则和项目规则
尝试切换其他模型
打开 AI 对话框后，提示 ”服务启动异常“
打开 AI 对话框后，若界面上提示 “服务启动异常“，可尝试通过以下方法解决：
服务器启动异常 服务器启动异常、重置数据
方法 步骤
重置数据 若 AI 对话框中出现 重置数据 的按钮，点击该按钮。
(Windows) 关闭防火墙 1. 前往 开始 > Windows Defender 防火墙 > 启用或关闭 Windows Defender 防火墙。
2. 选择 关闭 Windows Defender 防火墙，然后点击 确定。
3. 重启 Trae IDE。
清除历史对话 1. 点击右上角的 历史对话 图标。
2. 清除历史对话。
清除数据库 1. 完全退出 Trae IDE。
2. 在 PC 的终端中运行以下命令，清除数据库：
○ macOS：
~/Library/Application Support/Trae CN/ModularData
○ Windows：
%USERPROFILE%\AppData\Roaming\Trae CN\ModularData
3. 重启 Trae IDE。
快捷键失效
该问题一般由快捷键设置冲突导致，即为多个命令注册了同一个快捷键。尝试以下步骤进行解决：
使用 Command/Ctrl + Shift + P 快捷键打开命令面板，查找 开发人员：切换键盘快捷键疑难解答 命令并点击。
Trae开发人员：切换键盘快捷键疑难解答
IDE 底部显示 输出 面板，用于展示快捷键操作的相关信息。
在 IDE 中是使用快捷键。
输出 面板中展示该快捷键相关的命令信息。
复制快捷键当前所激活的命令的 ID。
先后使用 Command/Ctrl + K 和 Command/Ctrl + S 快捷键打开 键盘快捷键 窗口。
在输入框中输入所复制的命令的 ID。
窗口中展示命令名称以及所绑定的快捷键。
点击命令名称左侧的 修改 图标，修改该命令所绑定的快捷键。
此外，也有可能是因为你在 Trae IDE 内导入了来自其他 IDE 的快捷键配置，从而导致快捷键冲突问题。你可以点击下图所示的图标打开 keybindings.json 文件，然后删除不需要快捷键配置。
打开新的文件后，先前打开的文件标签页自动关闭
该问题由 Preview 模式导致。若无需使用该模式，使用以下步骤将其关闭：
前往 IDE 设置中心。
在 通用 设置面板的 Editor 设置 部分，点击 去设置 按钮。
在输入框中输入关键词 “Preview”。
在结果列表中找到 Workbench > Editor: Enable Preview 设置，然后将其关闭。
Python 相关
Python 无法通过 “Command/Ctrl + 鼠标左键” 跳转到函数定义
语法检测、跳转函数定义等类似的功能是由该语言对应的 Language Server Provider（简称 LSP）提供。以 Python 为例，如遇到了 Python 文件里无法通过快捷键跳转到函数定义，可能的原因有以下几种：
Trae CN 中未安装 Python 相关的 LSP 插件，如 Python、Pylance、Pyright 等。
Python 相关的 LSP 插件由于某些原因（如仓库过大等）未能加载成功。
受限于插件开发者的服务条款限制，Python 相关的 LSP 插件只能在特定产品中使用，如由 Microsoft 开发的 Python 插件明确提出只能在 VS Code 中使用。
同样以 Python 为例，针对无法跳转到函数定义的问题，可按照以下步骤逐一排查：
进入插件市场，检查是否已安装了 Python 相关的 LSP 插件。
若已安装了由 ms-python 提供的 Python、Pylance 插件，将其卸载。
提示
在 VS Code 中安装 Python 时一般会自动安装 Pylance，所以从 VS Code 或 Cursor 导入配置到 Trae CN 后，更容易遇到 LSP 不生效的问题。
如无 Python 插件或已将 ms-python 提供的插件卸载干净，请搜索并安装开源社区中 Python 相关的 Language Server，如 BasedPyright。
提示
BasedPyright 默认设置了较为严格的类型检查，为避免被过度干扰，建议将其调低 。步骤如下：
1.打开 Editor 设置，搜索 pyright type checking mode。
2.将默认的 recommended 模式修改为 basic 模式。
安装 BasedPyright 后，打开任意 Python 文件，鼠标右击任一一处引用的函数，在出现的菜单中可看到 “转到定义” 等菜单项，即说明 LSP 插件正常可用。 |
发表于