> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查看和审查代码改动

# 概述

在让 Qoder 修改代码后，你通常需要查看它改了什么，并对改动做一次审查。Qoder CLI 提供两种能力：用 `/diff` 查看具体的代码差异，用 `/review` 对改动做结构化的代码审查并找出可修复的问题。

这两种能力都基于 Git，因此需要在一个 Git 仓库中使用。

# 查看改动（/diff）

用 `/diff` 查看当前工作区的代码差异：

```shell theme={null}
/diff
```

它会展示已修改和新增（未跟踪）文件的具体变更内容，帮助你快速确认 Qoder 做了哪些改动。

# 审查改动（/review）

`/review` 会对代码改动做一次审查，找出其中可修复的问题。它有两种用法：

## 交互式选择审查范围

不带参数运行时，`/review` 会让你选择审查范围：

```shell theme={null}
/review
```

可选的审查范围包括：

* **当前改动（Current changes）**：审查已暂存、未暂存和未跟踪的文件。
* **对比基础分支（Base branch）**：选择一个本地分支，审查当前分支相对它的改动。
* **某个提交（Commit）**：从最近的提交列表中选择一个进行审查（最多列出 100 个提交）。
* **自定义指令（Custom instructions）**：输入自定义的审查要求。

## 直接给出审查指令

带参数运行时，参数会直接作为审查指令提交给 Qoder：

```shell theme={null}
/review 重点检查这次改动里的并发安全和错误处理
```

# 审查范围说明

| 范围 | 审查内容 |
| :- | :- |
| 当前改动 | 工作区中已暂存、未暂存和未跟踪的文件 |
| 对比基础分支 | 当前分支相对所选本地分支的差异 |
| 某个提交 | 选定提交引入的改动 |
| 自定义指令 | 按你输入的要求进行审查 |

选择"对比基础分支"时，如果本地存在 `main` 或 `master` 分支，会优先作为默认对比分支。

# 建议流程

一个常见的"改动—查看—审查"流程：

1. 让 Qoder 完成一项修改。
2. 用 `/diff` 快速查看它改了哪些内容。
3. 用 `/review` 做一次结构化审查，找出潜在问题。
4. 根据审查结果，让 Qoder 继续修正。

需要在提交前对整段改动做严格把关时，"对比基础分支"或"某个提交"的审查范围尤其有用。

> `/review` 和 `/diff` 都需要在 Git 仓库中运行。如果不在 Git 仓库、或没有可用的分支/提交，Qoder 会给出相应提示。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.