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 层是否显示为加粗绿色值 —— 加粗绿色表示该层级已主动设置且正在生效。
