Игнорирование файлов

В этом документе представлен обзор возможности игнорирования файлов с помощью .qwenignore в Qwen Code. Qwen Code также распознаёт пользовательские файлы игнорирования, заданные параметром context.fileFiltering.customIgnoreFiles, по умолчанию это файлы совместимости .agentignore и .aiignore.

Qwen Code умеет автоматически игнорировать файлы, аналогично тому, как это делает .gitignore (используемый в Git). Добавление путей в .qwenignore или настроенный пользовательский файл игнорирования исключит их из инструментов, поддерживающих эту функцию, хотя они останутся видимыми для других сервисов (например, Git).

Как это работает

Когда вы добавляете путь в один из этих файлов игнорирования, инструменты, учитывающие правила игнорирования Qwen, исключают соответствующие файлы и каталоги из своих операций. Например, при использовании команды read_many_files пути, указанные в .qwenignore или настроенном пользовательском файле игнорирования, будут автоматически исключены.

В основном эти файлы игнорирования следуют соглашениям .gitignore:

Пустые строки и строки, начинающиеся с #, игнорируются.
Поддерживаются стандартные glob-шаблоны (например, *, ? и []).
/ в конце означает, что правило применяется только к каталогам.
/ в начале привязывает путь относительно файла игнорирования.
! инвертирует правило.

Вы можете обновлять эти файлы игнорирования в любое время. Чтобы изменения вступили в силу, необходимо перезапустить сеанс Qwen Code.

Как использовать файлы игнорирования

Шаг	Описание
Включите правила игнорирования	Создайте `.qwenignore`, стандартный пользовательский файл (`.agentignore` / `.aiignore`) или настроенный пользовательский файл игнорирования в корневой директории проекта
Добавьте правила игнорирования	Откройте файл игнорирования и добавьте пути, которые нужно игнорировать, например: `/archive/` или `apikeys.txt`

По умолчанию Qwen Code читает .qwenignore, .agentignore и .aiignore. Чтобы использовать другой пользовательский файл игнорирования, задайте конфигурацию:


{
  "context": {
    "fileFiltering": {
      "customIgnoreFiles": [".cursorignore"]
    }
  }
}

.qwenignore всегда учитывается, когда context.fileFiltering.respectQwenIgnore включён. Пути пользовательских файлов игнорирования задаются относительно корня проекта.

Примеры файлов игнорирования

Вы можете использовать любой поддерживаемый файл игнорирования для исключения каталогов и файлов:


# Исключить каталог /packages/ и все его подкаталоги
/packages/

# Исключить файл apikeys.txt
apikeys.txt

В файле игнорирования можно использовать подстановочные знаки с *:


# Исключить все .md файлы
*.md

Наконец, можно исключить файлы и каталоги из исключения с помощью !:


# Исключить все .md файлы, кроме README.md
*.md
!README.md

Чтобы удалить пути из файла игнорирования, удалите соответствующие строки.