应配置user_rules.md和个人规则、project_rules.md和项目规则、启用Format On Save、集成.editorconfig文件、为Python项目绑定black或autopep8工具。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用Trae IDE时发现团队成员提交的代码风格不一致,例如缩进方式、命名习惯或括号位置存在差异,则可能是由于缺乏统一的代码风格与格式化规则配置。以下是实现编码规范统一的具体操作路径:
一、配置个人规则文件(user_rules.md)
个人规则适用于所有项目,不随Git提交,用于固化开发者长期偏好的基础约束。该文件定义AI生成代码时必须遵循的语言、注释、结构等底层规范。
1、在Trae IDE中点击右侧AI功能管理区域的设置按钮。
2、进入“规则面板”,点击新建规则。
3、在左侧编辑器中粘贴或编写符合团队要求的规则文本,例如命名规范、注释语言、异常处理强制要求等。
4、将该规则文件保存为user_rules.md,并确保其位于用户主目录下的.trae/rules/路径中。
5、重启Trae IDE使规则生效,AI后续所有代码生成行为将自动读取并遵守该文件中的指令。
二、配置项目级规则文件(project_rules.md)
项目规则作用于当前工作区,会被纳入Git版本控制,是团队协作中强制对齐编码实践的核心载体。它覆盖个人规则,优先级更高,确保新成员开箱即用。
1、在项目根目录下新建文件,命名为project_rules.md。
2、按团队规范填充内容,例如:类名使用PascalCase、私有字段以下划线开头、数据库操作必须包裹try-catch、SQL必须参数化。
3、打开Trae IDE设置(Settings),定位到“代码生成(Code Generation)”选项。
4、将“规则文件路径”指向该项目下的project_rules.md绝对路径。
5、保存设置并重启IDE,项目内所有AI辅助操作将严格依据该文件执行。
三、启用保存时自动格式化(Format On Save)
该功能确保人工编写的代码在保存瞬间被标准化处理,消除手动格式化遗漏,与规则形成双重保障。它不改变逻辑,仅调整空格、换行、缩进等视觉结构。
1、点击Trae右上角三个点图标,选择“Configure Editors”。
2、在搜索框中输入Format On Save。
3、勾选该选项,完成启用。
4、可进一步在设置中确认所用格式化工具是否为Prettier或editorconfig兼容引擎。
四、集成.editorconfig配置文件
.editorconfig是跨编辑器通用的格式化元配置,独立于Trae运行,但能与Trae的格式化行为协同生效,尤其适用于混合编辑器环境下的团队。
1、在项目根目录创建名为.editorconfig的纯文本文件。
2、写入标准配置项,例如:indent_style = space、indent_size = 4、end_of_line = lf、charset = utf-8。
3、确保Trae已安装EditorConfig插件(国内版默认启用)。
4、保存文件后,Trae会自动识别并应用其中定义的缩进、换行、字符集等基础格式策略。
五、配置Python项目专用格式化规则
针对Python项目,需额外绑定解释器级格式化工具(如black或autopep8),避免Trae内置格式器与PEP8规范冲突。
1、进入Trae设置 > Project > Python Interpreter。
2、点击齿轮图标,选择“Show All”,再点击右侧“+”添加新工具。
3、选择“Black”或“Autopep8”作为代码格式化程序,并指定其可执行路径。
4、在项目设置中启用“Format on Save for Python files”子选项。
5、验证:新建.py文件,输入未格式化代码后保存,观察是否自动转为PEP8合规样式。


















