ファイルの無視

このドキュメントでは、Qwen Code の Qwen Ignore (.qwenignore) 機能について概説します。

Qwen Code には、Git で使用される .gitignore と同様に、ファイルを自動的に無視する機能が備わっています。.qwenignore ファイルにパスを追加すると、そのパスはこの機能に対応するツールから除外されますが、他のサービス（たとえば Git）からは引き続き表示されます。

動作の仕組み

.qwenignore ファイルにパスを追加すると、このファイルを尊重するツールは、該当するファイルおよびディレクトリを操作対象から自動的に除外します。たとえば、read_many_files コマンドを使用する場合、.qwenignore ファイルに記述されたパスは自動的に除外されます。

基本的に、.qwenignore は .gitignore ファイルの規則に従います。

• 空行および # で始まる行は無視されます。
• 標準の glob パターン（例：*、?、[]）がサポートされています。
• パターン末尾に / を付けると、ディレクトリのみにマッチします。
• パターン先頭に / を付けると、そのパスは .qwenignore ファイルを基準とした相対パスとして解釈されます。
• ! を付けると、そのパターンは否定（除外の例外）として扱われます。

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

.qwenignore の使用方法

.qwenignore の例

.qwenignore を使用して、ディレクトリやファイルを無視できます。

# /packages/ ディレクトリおよびそのすべてのサブディレクトリを除外
/packages/

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

.qwenignore ファイルでは、ワイルドカード * を使用できます。

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

最後に、! を使用して、除外対象から特定のファイルやディレクトリを再び含めることもできます。

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

.qwenignore ファイルからパスを削除するには、該当する行を削除します。