ファイルの無視

このドキュメントでは、Qwen Code の Qwen Ignore (.qwenignore) 機能の概要を説明します。

Qwen Code には、ファイルを自動的に無視する機能が含まれています。これは .gitignore (Git で使用される) と同様のものです。.qwenignore ファイルにパスを追加することで、この機能をサポートするツールからそれらのファイルを除外できますが、他のサービス (Git など) からは引き続き表示されます。

仕組み

.qwenignore ファイルにパスを追加すると、このファイルを尊重するツールは、操作から該当するファイルやディレクトリを除外します。例えば、read_many_files コマンドを使用する際、.qwenignore ファイル内のすべてのパスは自動的に除外されます。

大まかに言えば、.qwenignore は .gitignore ファイルの慣習に従います：

• 空行や # で始まる行は無視されます。
• 標準的な glob パターンがサポートされています（例：*、?、[]）。
• 末尾に / を置くと、ディレクトリのみにマッチします。
• 先頭に / を置くと、.qwenignore ファイルからの相対パスとして扱われます。
• ! はパターンを否定します。

.qwenignore ファイルはいつでも更新可能です。変更を適用するには、Qwen Code セッションを再起動する必要があります。

.qwenignore の使い方

.qwenignore を有効にするには：

1. プロジェクトディレクトリのルートに .qwenignore という名前のファイルを作成します。

ファイルやディレクトリを .qwenignore に追加するには：

1. .qwenignore ファイルを開きます。
2. 無視したいパスまたはファイルを追加します。例：/archive/ や apikeys.txt。

.qwenignore の例

.qwenignore を使ってディレクトリやファイルを無視できます：

# /packages/ ディレクトリとそのサブディレクトリを除外
/packages/

# apikeys.txt ファイルを除外
apikeys.txt

.qwenignore ファイルでは * を使ってワイルドカードが使えます：

# すべての .md ファイルを除外
*.md

最後に、! を使って除外対象から特定のファイルやディレクトリを除外解除できます：

# README.md を除くすべての .md ファイルを除外
*.md
!README.md

.qwenignore ファイルからパスを削除するには、該当する行を削除してください。