Qoder一键美化代码需依次启用自动格式化策略或语义感知修饰引擎：一、用Shift+Alt+F快捷键触发LSP驱动的语义级格式化；二、通过命令面板选择作用域执行高级修饰；三、开启保存时自动格式化；四、调用Qoder Agent实现跨文件语义一致性美化；五、自定义.qoder/format.json规则。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Qoder中编辑代码时发现格式松散、缩进不一致或可读性较差，希望快速提升代码整洁度与视觉规范性，则可能是当前文件未启用自动格式化策略或未触发语义感知修饰引擎。以下是实现Qoder一键美化代码的具体操作路径：
一、使用快捷键触发内置格式化
Qoder集成语言服务器协议（LSP）驱动的智能格式化能力，支持基于AST结构的语义级重排，可自动修正缩进、空格、换行、括号对齐及运算符间距等细节，且不改变代码逻辑语义。
1、确保当前打开的文件已被Qoder正确识别语言类型（如Java、TypeScript、Python等），状态栏右下角显示对应语言标识。
2、将光标置于待美化代码任意位置，或按Ctrl+A（Windows/Linux）或⌘+A（macOS）全选代码内容。
3、按下快捷键Shift+Alt+F（Windows/Linux）或⇧⌥F（macOS），Qoder将立即调用语言专属格式化器执行重构。
4、若首次使用该语言格式化，系统可能弹出提示框询问是否启用推荐配置，点击启用并应用以激活Prettier或EditorConfig兼容规则。
二、通过命令面板调用高级修饰命令
Qoder提供多粒度代码修饰指令，支持按作用域（当前行、选区、文件、项目）执行差异化美化，适用于需保留特定风格约束或跳过敏感区块的场景。
1、按下Ctrl+Shift+P（Windows/Linux）或⌘+Shift+P（macOS）打开命令面板。
2、输入Qoder: Format Code并回车，进入修饰模式选择界面。
3、从下拉列表中选择目标范围：Format Selection（仅美化选中代码）、Format Document（整文件美化）、Format Workspace（跨所有打开文件批量美化）。
4、确认后，Qoder将依据项目根目录下的.editorconfig、.prettierrc或.qoder/format.json自动匹配规则并执行。
三、启用保存时自动美化
开启此功能后，每次保存文件时Qoder将隐式调用格式化器，确保代码始终处于统一风格状态，避免人工遗漏，特别适合团队协作开发环境。
1、打开Qoder设置界面：点击左下角齿轮图标 → 选择「Settings」。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、在搜索框中输入format on save，定位到Editor: Format On Save选项。
3、勾选该复选框，并同步启用Editor: Format On Save Mode设为modifications以仅重写变更区域，提升性能。
4、如需排除特定文件类型，可在Files: Associations中添加例外，例如将*.min.js映射为plaintext防止误格式化。
四、通过Qoder Agent执行跨文件语义一致性美化
当项目中存在多个关联文件（如React组件及其样式文件、Spring Boot Controller与DTO类）需保持命名、缩进、注释风格统一时，可调用Agent模式进行上下文感知的批量修饰。
1、在侧边栏点击「Agent」图标，或使用快捷键Ctrl+Shift+A（Windows/Linux）/⌘+Shift+A（macOS）启动智能体。
2、在对话框中输入自然语言指令：“统一美化src/components/目录下所有TSX文件：使用2空格缩进、属性换行、JSX标签闭合对齐”。
3、等待Agent解析项目结构并生成预览计划，其中包含每个文件的diff对比及修改理由说明。
4、检查无误后点击Apply All，Qoder将原子化执行全部变更，并在终端输出Formatted 12 files successfully日志。
五、自定义代码修饰规则（.qoder/format.json）
通过声明式JSON配置，开发者可覆盖默认修饰行为，定义语言专属的代码块间距、注释样式、导入排序逻辑等，该配置随仓库提交，保障团队编码风格强一致性。
1、在项目根目录创建隐藏文件夹.qoder。
2、在该目录下新建文件format.json，写入结构化规则（示例：强制TypeScript接口成员按字母序排列）。
3、规则字段包括indentSize、quoteStyle、jsxBracketSameLine、importOrder等，完整字段参考https://docs.qoder.com/zh/formatting/rules。
4、保存后Qoder自动热加载配置，后续所有格式化操作均优先采用该规则集。
