Cómo excluir archivos del uso de Gemini Code Assist

Gemini Code Assist admite la exclusión de archivos de tu contexto para la generación, la finalización y la transformación de código, y el chat. Para los usuarios de Enterprise, esto también incluye la personalización de código.

En muchos casos, tendrás archivos o subárboles específicos que no querrás incluir en tu contexto.

Puedes excluir estos archivos mediante el uso de un archivo .aiexclude o .gitignore. Los usuarios de Gemini CLI pueden excluir archivos con un .geminiignore archivo.

Configura los parámetros de configuración de exclusión de contexto

En esta sección, se muestra cómo configurar los parámetros de configuración para los archivos .aiexclude y .gitignore.

Cambia el archivo .aiexclude por el archivo que prefieras

De forma predeterminada, la exclusión de contexto está configurada para usar .aiexclude. Para cambiar este parámetro de configuración en tu IDE, sigue estos pasos:

VS Code

  1. En la barra de actividades, haz clic en settings Administrar > Configuración.

  2. En la ventana Configuración, navega a Extensiones > Gemini Code Assist. Desplázate hasta que encuentres Archivo de exclusión de contexto.

  3. En el campo de texto, cambia .aiexclude a la ubicación que prefieras.

El archivo que prefieras ahora está configurado como el archivo de exclusión de contexto.

IntelliJ

La configuración de los parámetros de configuración para los archivos .aiexclude y .gitignore no es compatible con los IDE de JetBrains.

Cambia la exclusión de contexto de .gitignore

De forma predeterminada, el archivo .gitignore está habilitado para la exclusión de contexto. El archivo debe ubicarse en la carpeta de trabajo raíz de Gemini Code Assist. Los archivos .gitignore ubicados en subdirectorios no se considerarán ni se combinarán.

Para inhabilitar los archivos .gitignore de la exclusión de contexto, sigue estos pasos:

  1. En la barra de actividades, haz clic en settings Administrar > Configuración.

  2. En la ventana Configuración, navega a Extensiones > Gemini Code Assist. Desplázate hasta que encuentres Context Exclusion Gitignore.

  3. Anula la selección de la casilla de verificación.

    Los archivos .gitignore ahora están inhabilitados para especificar el archivo que Gemini Code Assist debe ignorar.

Escribe un archivo .aiexclude

Un archivo .aiexclude tiene la misma sintaxis que un archivo .gitignore.

Ejemplos

En los siguientes ejemplos, se muestra cómo puedes configurar un archivo .aiexclude:

  • Bloquea todos los archivos llamados apikeys.txt en el directorio que contiene el archivo .aiexclude o debajo de él:

    apikeys.txt

  • Bloquea todos los archivos con la extensión de archivo .key en el directorio que contiene el archivo .aiexclude o debajo de él:

    *.key

  • Bloquea solo el archivo apikeys.txt en el mismo directorio que .aiexclude, pero no en ningún subdirectorio:

    /apikeys.txt

  • Bloquea todos los archivos del directorio my/sensitive/dir y todos los subdirectorios. La ruta de acceso debe ser relativa al directorio que contiene el archivo .aiexclude:

    my/sensitive/dir/

  • Bloquea todos los archivos del directorio foo y sus subdirectorios, excepto el archivo llamado bar.txt en el directorio foo.

    foo/*
!foo/bar.txt

Controla el acceso al índice para la personalización de código

De forma predeterminada, la personalización de código indexa todos los archivos de código compatibles en los repositorios especificados.

Para evitar la exposición del código que no quieres que se use en el contexto, puedes usar patrones de ramas para controlar el acceso a tu índice y usar una rama estable, como main.

Como alternativa, también puedes excluir archivos del contexto mediante la creación de un archivo .aiexclude.