---
title: 監視模式
description: 透過 Repomix 監視模式在檔案變更時自動重新打包程式碼庫，包含防抖、忽略規則處理以及選項相容性。
---

# 監視模式

Repomix 可以監視你的程式碼庫，並在檔案變更時自動重新打包。這能讓輸出檔案在你工作期間保持最新，當你想要將持續更新的快照提供給 AI 助理時非常方便。

## 用法

使用 `-w`（或 `--watch`）旗標啟動監視模式：

```bash
repomix --watch
```

Repomix 會先執行一次初始打包，接著持續執行並在每次變更時重新打包。你可以將監視模式與一般選項結合使用：

```bash
# 監視特定的一組檔案
repomix -w --include "src/**/*.ts"

# 使用自訂的輸出檔案與格式進行監視
repomix --watch -o output.md --style markdown
```

按下 `Ctrl+C` 即可停止監視。

## 運作方式

- **初始打包**：Repomix 會先打包程式碼庫一次，然後回報它正在監視多少個檔案。
- **變更偵測**：新增、變更與刪除檔案都會觸發重新打包。
- **防抖**：短時間內密集的變更（例如切換分支或一次儲存大量檔案）會被合併處理。Repomix 會在最後一次變更後等待 `300 ms` 才重新打包，因此一連串的編輯只會產生一次重建。
- **時間戳記**：每次重建後，Repomix 會印出一個時間戳記（`Rebuilt at HH:MM:SS`），讓你能夠得知輸出上次更新的時間。

## 被忽略的檔案

監視模式遵循與一般執行相同的忽略規則：`.gitignore`、`.repomixignore`、內建的預設模式（例如 `node_modules` 與 `.git`），以及你傳入的任何 `--ignore` 模式。被忽略的目錄不會被監視，這能讓監視模式在大型專案上保持高效率。

## 選項相容性

監視模式僅適用於本機目錄，因此無法與下列選項結合使用（無論你是在命令列上設定，還是在設定檔中設定）：

- `--remote` 或位置參數形式的遠端儲存庫 URL — 監視模式僅限本機
- `--stdout` 或 `--stdin` — 串流模式沒有可供更新的持續性輸出檔案
- `--split-output`
- `--skill-generate`
- `--copy` — 每次變更都重新打包會反覆覆寫剪貼簿

如果你將上述任一選項與 `--watch` 結合使用，Repomix 會結束並顯示說明該衝突的錯誤訊息。

## 相關資源

- [命令列選項](/zh-tw/guide/command-line-options) - 完整的 CLI 參考，包含 `--watch`
- [基本用法](/zh-tw/guide/usage) - 其他執行 Repomix 的方式
- [設定](/zh-tw/guide/configuration) - 在設定檔中設定預設輸出選項
