> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

本文档汇总了在 TRAE 中使用各类编程语言时，你可能遇到的问题及相应的解决方法。
## Python 相关 {#fb5a82d9}
### Python 无法通过 “Command/Ctrl + 鼠标左键” 跳转到函数定义 {#f5842995}
语法检测、跳转函数定义等类似的功能是由该语言对应的 Language Server Provider（简称 LSP）提供。以 Python 为例，如遇到了 Python 文件里无法通过快捷键跳转到函数定义，可能的原因有以下几种：

* Trae CN 中未安装 Python 相关的 LSP 插件，如 Python、Pylance、Pyright 等。
* Python 相关的 LSP 插件由于某些原因（如仓库过大等）未能加载成功。
* 受限于插件开发者的[服务条款限制](https://marketplace.visualstudio.com/items/ms-python.vscode-pylance/license)，Python 相关的 LSP 插件只能在特定产品中使用，如由 Microsoft 开发的 Python 插件明确提出只能在 VS Code 中使用。

同样以 Python 为例，针对无法跳转到函数定义的问题，可按照以下步骤逐一排查：

1. 进入插件市场，检查是否已安装了 Python 相关的 LSP 插件。
   ![Image=2880x1801](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/25d30ec59b1840ef910ca166d92c06d0~tplv-goo7wpa0wc-image.image)
2. 若已安装了由 ms-python 提供的 Pylance 插件，将其卸载。
   :::tip 提示
   在 VS Code 中安装 Python 时一般会自动安装 Pylance，所以从 VS Code 或 Cursor 导入配置到 Trae CN 后，更容易遇到 LSP 不生效的问题。
   :::
   ![Image=1280x549](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/010267c29ded42ce834ca152d1cb6961~tplv-goo7wpa0wc-image.image)
3. 搜索并安装开源社区中 Python 相关的 Language Server，如 BasedPyright。
   ![Image=2880x1801](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1739fedb20494f2eb573a93515ec1866~tplv-goo7wpa0wc-image.image)
   :::tip 提示
   BasedPyright 默认设置了较为严格的类型检查，为避免被过度干扰，建议将其调低 。步骤如下：
   
   1. 打开 Editor 设置，搜索 pyright type checking mode。
   2. 将默认的 recommended 模式修改为 basic 模式。
   :::
4. 安装 BasedPyright 后，打开任意 Python 文件，鼠标右击任一一处引用的函数，在出现的菜单中可看到 “转到定义” 等菜单项，即说明 LSP 插件正常可用。
   ![Image=2880x1801](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/cd4d17fcfa674351b0fad8571181ca53~tplv-goo7wpa0wc-image.image)

### Python 代码中，使用 F2 键修改变量名会使每一行后都添加空行 {#9f78efab}
微软的 Python 插件自带了语言服务 Jedi，无需使用它。前往插件市场，然后安装 BasedPyright 插件进行使用。
### 无法使用代码跳转功能 {#13da97c2}
参考以下解决方法：

* Python 插件 2025.6.1 版本在某些项目上会报错，你可以安装 BasedPyright 插件作为替代。
* 检查 Python 语言服务插件，如 BasedPyright 插件是否被禁用。若被禁用，需将其开启。
* 检查 Python 语言服务是否崩溃。若奔溃，使用 Command/Ctrl + Shift + P 快捷键打开命令面板，然后使用 **Python：重启语言服务器** 命令来重启 LSP。
   ![Image=600x243](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1bbec623b79b4570ba78b2070f48eebf~tplv-goo7wpa0wc-image.image)

### 语法高亮功能失效 {#9297055f}
打开插件市场，然后找到 Python 插件。若插件的状态如下图所示，需卸载后再重新安装。
![Image=400x78](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/05c9fb99bf374db5af60c5afb9dbd107~tplv-goo7wpa0wc-image.image)
### 无法自动激活 Conda/venv 环境 {#6ef71f34}
目前 Python 插件的已知 Bug 如下：

* https://github.com/microsoft/vscode-python/issues/25051
* https://github.com/microsoft/vscode-python/issues/25284
* https://github.com/microsoft/vscode-python/issues/25267

此问题的临时解决方案如下：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板。
2. 点击 **首选项：打开用户设置（JSON）** 选项来打开 settings.json 文件。
   ![Image=600x233](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3d8be525720843c1bfce025164eb9bb2~tplv-goo7wpa0wc-image.image)
3. 在 settings.json 文件中添加以下配置：
   ```JSON
     "python.experiments.optOutFrom": [
       "pythonTerminalEnvVarActivation"
     ],
   ```

4. 保存文件，然后重启 IDE。

## Go 相关 {#49f587ec}
### 安装 gopls 时出现如下报错: go/pkg/sumdb/sum.golang.org/latest: no such file or directory {#7b8504f6}
检查当前用户是否有 ~/go 目录的写入权限。如果没有该权限，可以使用以下命令修改权限：
```Bash
sudo chmod -R 777 ~/go
```

### Go 1.17 版本无法使用语言服务 {#f8159ae9}
Trae IDE 会根据用户当前使用的 Go 版本自动安装对应的 gopls 二进制文件。但如果你使用的是 Go 1.17，Trae IDE 无法通过 `go` 命令正确识别该版本的 gopls 二进制文件，因此可能会导致无法使用语言服务。此时，先手动删除已安装的 gopls 二进制文件、dlv 文件和 staticcheck 文件，然后重启 Trae ID。
```TypeScript
rm ~/go/bin/gopls // 删除 /go/bin 目录中的 gopls 文件
rm ~/go/bin/dlv // 删除 /go/bin 目录中的 dlv 文件
rm ~/go/bin/staticcheck // 删除 /go/bin 目录中的 staticcheck 文件
```

### go.mod 文件报错 “"{{context.GOARCH}} {{context.Compiler}}": invalid char '{'” {#99e2164c}
使用以下步骤来解决该问题：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板，点击 **首选项：打开用户设置（JSON）** 选项来打开 settings.json 文件，然后检查该文件中是否存在 `go.buildFlags` 配置。若有，删除该配置。
   ![Image=600x233](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3d8be525720843c1bfce025164eb9bb2~tplv-goo7wpa0wc-image.image)
2. 若步骤一无法解决问题，使用 Command/Ctrl + Shift + P 快捷键打开命令面板，然后使用 **Go：Install/Update Tools** 命令来重装 Go Tools。
   ![Image=600x266](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/40d0b6f934f349edb063d7bbe309c2a6~tplv-goo7wpa0wc-image.image)

### 无法在代码间跳转 {#6550ed9b}
若无法在代码间跳转，任何函数和类都显示正在加载中，且重启 Trae IDE 无法解决该问题，尝试以下步骤：

1. 打开终端，执行 `go env` 命令，检查是否配置了内网的 `GOPROXY`。如果没有配置内网代理，将无法拉取 Go 依赖，导致代码分析和跳转功能异常。
   下图中为未配置内网 `GOPROXY` 的示例：
   ![Image=600x167](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/65074ad26f2b44d4934024c148bc2642~tplv-goo7wpa0wc-image.image)
2. 如果未配置内网的 `GOPROXY`，请根据公司或网络环境，正确设置内网的 `GOPROXY`。
3. 配置完成后，重新启动 Trae IDE。

## Java 相关 {#10fa8cd9}
### 无法识别 Lombok 注解的类的方法 {#607f4584}
你可能在 IDE 中安装了多个 Java 插件，其中某些插件无法正确识别 Lombok，导致编辑器中出现错误提示。而 Red Hat Java 插件能够正常识别 Lombok，支持代码跳转等功能。
你需要卸载无法正确支持 Lombok 的 Java 插件（例如 Java Language Support），只保留 Red Hat Java 插件。
## TypeScript 相关 {#70ea3fac}
### TypeScript 语言服务无法使用 {#36524082}
使用以下步骤解决该问题：

* 检查 TypeScript  插件是否被禁用。若被禁用，将其启用。
* 若 TypeScript 插件未被禁用，则需要重启 TypeScript 的语言服务：
   1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板。
   2. 使用 **TypeScript：重启 TS 服务器** 命令。
      ![Image=600x184](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/214b462c4d6949bab5bb667b99597f2d~tplv-goo7wpa0wc-image.image)

### 无法找到需 import 的模块 {#4c407ce6}
检查项目是否已初始化、node_modules 是否已安装。
![Image=759x221](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/651d67c9126a4fcc95d8f88ffc8e1d56~tplv-goo7wpa0wc-image.image)
## C/C++ 相关 {#4c8c6a56}
### 无法识别 `#include` 指令、跳转功能失效 {#0362dfe9}
检查是否同时安装了 clangd 和 Microsoft C/C++ 插件。这两个插件不能同时安装，否则会冲突，导致跳转等功能异常。如果同时安装上述两个插件，卸载其中一个。建议保留你平时主要使用的插件。
此外，你需要让你的编译工具生成一个 compile_commands.json 文件，声明哪些文件需要编译，每个文件的编译参数是什么。目前 clangd 插件和 Microsoft C/C++ 插件都支持 compile_commands.json 文件（详见[此文档](https://clangd.llvm.org/installation#project-setup)）。你可以将 compile_commands.json 文件放在项目根目录，或者根目录下的 build 文件夹中。
如果你使用的构建工具是 CMake，可以执行以下命令来生成一个 compile_commands.json 文件：
```Bash
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1
```

如果你使用的构建工具是 XMake，使用以下命令：
```Bash
xmake project -k compile_commands
```

###  配置 C++ 远程调试时，报错 “配置的类型‘cppdbg’不受支持”  {#77802dae}
该错误通常是因为远程环境未安装必需的 C/C++ 插件。确保在远程机器（或远程开发环境）中安装了 Microsoft 的 C/C++ 插件（通常名称为 `ms-vscode.cpptools`），以支持 `cppdbg` 调试类型。
安装完成后，重启远程环境，再次尝试调试。
## Vue 相关 {#d44a30ae}
### Vue 文件未高亮，无法跳转 {#e0153798}
需要安装 Vue - Official 插件实现 Vue 的语法高亮以及语言服务。你可以通过以下两种方式安装：

* 打开 .vue 文件时，IDE 界面右下角会提醒安装 Vue - Official 插件，可以点击安装。
* 在插件市场搜索 Vue - Official，安装该插件。

### Vue 服务器短时间内多次崩溃，无法重启 {#d1eaeb6b}
若出现 “The Vue server crashed 5 times in the last 3 minutes. The server will not be restarted. See the output for more information“ 错误，检查是否安装了3.0.0-alpha.6 版本的 Vue - Official 插件。若是，卸载该版本，然后安装其他版本。
### 行注释功能失效 {#c419562e}
若行注释功能（macOS： command + /；Windows：ctrl + /）失效，一般是因为 Vue 的语言服务已崩溃，使用以下步骤重启：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板。
2. 使用 **Vue：Restart Vue and TS servers** 命令重启 Vue 的语言服务。
   ![Image=600x141](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/30919f7a96a84249b3b419e120d884b3~tplv-goo7wpa0wc-image.image)

### 代码折叠失效 {#502442ef}
若代码折叠失效，一般是因为 Vue 的语言服务已崩溃，使用以下步骤重启：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板。
2. 选择 **Vue：Restart Vue and TS servers** 命令。
   ![Image=600x141](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/30919f7a96a84249b3b419e120d884b3~tplv-goo7wpa0wc-image.image)