Qoder一键美化代码：代码修饰功能使用指南
长期编写代码，难免遭遇格式混乱、缩进不一的困境。尤其在团队协作中，各成员的编码偏好差异，常导致代码库像“大杂烩”般难以维护。
那么，如何让Qoder中的代码实现一键整齐排列？
答案是肯定的。以下是具体的实现方法。
快捷键触发：内置格式化一键搞定
Qoder 集成基于语言服务器协议（LSP）的智能格式化引擎。它不仅能调整缩进，更从抽象语法树（AST）层面执行语义级重排，自动校正空格、换行、括号对齐及运算符间距，且完全不影响代码逻辑。
操作步骤简洁：
首先，确认Qoder已正确识别当前文件的编程语言类型（状态栏右下角显示语言标识，如Java、TypeScript、Python等）。
接着，将光标置于代码任意位置，或按下 Ctrl+A（Windows/Linux）/ ⌘+A（macOS）全选文件。
然后，直接按下快捷键 Shift+Alt+F（Windows/Linux）/ ⇧⌥F（macOS）。Qoder 将即刻调用对应的语言格式化器，使代码变得整洁。
首次使用某语言的格式化功能时，系统可能弹出提示框询问是否启用推荐配置。直接点击「启用并应用」——这会自动激活Prettier或EditorConfig兼容规则，免去手动配置。
命令面板：灵活掌控高级格式化
若仅需格式化某段代码，或某些区块需保留特定风格（如自动生成代码），则可通过命令面板实现精细控制。
按下 Ctrl+Shift+P（Windows/Linux）/ ⌘+Shift+P（macOS）打开命令面板，输入 Qoder: Format Code 并回车，即可进入格式化模式选择界面。
提供以下选项：
- Format Selection：仅美化选中的代码片段
- Format Document：美化整个文件
- Format Workspace：批量格式化所有打开的文件
选定范围后，Qoder 将依据项目根目录下的 .editorconfig、.prettierrc 或 .qoder/format.json 自动匹配规则并执行。该功能尤其适用于“部分格式化、部分保留”的场景。
自动保存：代码时刻保持整洁
手动格式化虽有效，但更省心的方法是让编辑器自动执行。
打开Qoder设置界面（点击左下角齿轮图标 → 选择「Settings」），在搜索框输入 format on save，找到 Editor: Format On Save 选项并勾选。
建议同时将 Editor: Format On Save Mode 设为 modifications——这样仅格式化被修改的区域，提升大文件处理性能。
若对特定文件类型有特殊要求（如不希望格式化 .min.js 压缩文件），可在 Files: Associations 中添加例外规则，将其映射为 plaintext，避免误格式化。
Agent 模式：跨文件统一风格
项目规模扩大，涉及文件增多（如React组件及其样式文件、Spring Boot的Controller与DTO类），若文件间风格不一致，维护成本剧增。此时，Qoder Agent 可大显身手。
点击侧边栏「Agent」图标，或按下快捷键 Ctrl+Shift+A（Windows/Linux）/ ⌘+Shift+A（macOS）启动智能体。
在对话框中输入自然语言指令即可。例如：
“统一格式化 src/components/ 目录下所有 TSX 文件：使用 2 空格缩进、属性换行、JSX 标签闭合对齐”
Agent 将解析项目结构，生成格式化预览计划，包含每个文件的 diff 对比及修改说明。确认无误后，点击 Apply All，Qoder 将原子化执行所有变更，终端输出类似 Formatted 12 files successfully 的日志。
对大型项目而言，该功能堪称“一键福音”。
自定义规则：构建团队专属编码规范
若你是注重细节的开发者，或团队遵循严格编码规范，通过声明式 JSON 配置覆盖默认行为，是最可靠的方式。
在项目根目录创建隐藏文件夹 .qoder，新建文件 format.json，编写结构化规则。例如强制 TypeScript 接口成员按字母序排列，或强制使用单引号。
常见规则字段包括：
indentSize：缩进空格数quoteStyle：引号类型jsxBracketSameLine：JSX 括号是否位于同一行importOrder：导入语句排序规则
完整字段列表参见官方文档：https://docs.qoder.com/zh/formatting/rules。
保存配置后，Qoder 自动热加载，后续格式化操作将优先使用该规则集。关键优势在于：配置文件随代码提交至仓库——团队成员拉取后风格自动统一，彻底终结“空格 vs Tab”之争。