Trae 通过全局、项目(.trae/settings.json)、工作区(.trae/workspace-settings.json)三级配置实现差异化设置,优先级逐级覆盖;需按路径创建对应文件并用设置面板或命令验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 Trae 时希望为不同项目分别应用独立的配置(如语言服务器路径、AI 模型偏好、代码格式化规则等),而非统一套用全局设置,则需明确区分工作区级配置与项目级配置的生效机制。以下是实现此目标的具体操作路径:
一、理解工作区与项目配置的优先级关系
Trae 的配置体系采用三级覆盖机制:全局配置 被项目文件夹内的 .trae/settings.json 覆盖,而项目配置又 被当前聚焦窗口所处工作区的 .trae/workspace-settings.json 覆盖。注意:工作区本身不创建新配置层级,仅通过其根目录下的 workspace-settings.json 文件提供比项目配置更高优先级的覆盖能力。
1、确认当前窗口是否已聚焦于某项目文件夹内——只有聚焦状态下,该文件夹才被视为“活动项目”。
2、检查项目根目录是否存在 .trae 文件夹;若无,需手动创建。
3、工作区配置文件必须位于工作区根目录(即多个项目共同父目录)下的 .trae/workspace-settings.json 中,且该目录需通过 File → Add Folder to Workspace 或命令行 trae
二、在项目根目录配置 .trae/settings.json
此方式适用于单项目独有设置,例如为 Go 项目指定 gopls 路径,或为 Python 项目绑定特定虚拟环境解释器。该配置仅对该文件夹及其子目录生效,不随工作区切换而改变。
1、在项目根目录下新建文件夹名为 .trae。
2、在 .trae 文件夹中新建文件 settings.json。
3、编辑 settings.json,填入 JSON 格式配置项,例如:
{"go.gopath": "D:\projects\go", "python.defaultInterpreterPath": "./.venv/Scripts/python.exe"}。
4、保存后重启 Trae 或执行 Ctrl+Shift+P → “Developer: Reload Window” 刷新配置。
三、在工作区根目录配置 .trae/workspace-settings.json
当多个项目共享同一组开发约束(如统一启用某 AI 模型、禁用特定 LSP、设置共用调试端口)时,应在工作区根目录配置 workspace-settings.json。该文件对所有加入该工作区的项目均生效,且优先级高于各项目自身的 settings.json。
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
1、确保已通过 File → Open Folder 打开一个空目录作为工作区根目录,或使用 trae /path/to/workspace 命令启动。
2、在该根目录下创建 .trae 文件夹。
3、在 .trae 文件夹中新建 workspace-settings.json。
4、写入配置内容,例如:
{"ai.model": "deepseek-r3", "editor.formatOnSave": true, "files.exclude": {"**/node_modules": true}}。
5、将其他项目文件夹通过 File → Add Folder to Workspace 添加进当前工作区窗口。
四、使用 Trae 内置设置面板按作用域筛选编辑
Trae 提供图形化界面直接编辑不同作用域的配置,避免手动创建和定位 JSON 文件出错。设置面板会自动识别当前上下文并高亮可编辑的作用域,确保修改写入正确位置。
1、按下 Ctrl+,(Windows/Linux)或 Cmd+,(macOS)打开设置面板。
2、点击右上角齿轮图标 → “Open Settings (JSON)”旁的下拉箭头。
3、从下拉菜单中选择 “Workspace” 或 “Folder” —— 若当前聚焦的是项目文件夹,“Folder” 即对应该项目的 .trae/settings.json;若当前为多文件夹工作区,“Workspace” 即对应 .trae/workspace-settings.json。
4、在打开的 JSON 编辑器中输入键值对,例如 "files.trimTrailingWhitespace": true。
5、保存文件,Trae 将立即应用变更。
五、验证配置是否按预期生效
配置写入后需确认其实际作用范围,防止因路径错误或作用域误选导致设置未加载。Trae 提供实时配置检查功能,可逐层查看当前文件所继承的最终配置值。
1、在任意代码文件中右键 → “Open Command Palette”(或 Ctrl+Shift+P)。
2、输入 “Preferences: Configure Language Specific Settings…” 并回车。
3、选择当前文件类型(如 “Go” 或 “Python”),进入语言专属设置页。
4、点击右上角 “Show Settings at Each Level” 图标(两个重叠方块),展开显示 Global / Workspace / Folder 三层配置值。
5、检查目标配置项在 Folder 或 Workspace 层是否显示为加粗绿色值 —— 加粗绿色表示该层级已主动设置且正在生效。

















