Plantilla .gitignore de JetBrains explicada
Explica por qué JetBrains.gitignore ignora solo la configuración personal y los archivos sensibles de la carpeta .idea de IntelliJ, PyCharm, WebStorm y otros, y en qué se diferencia de ignorar .idea por completo.
JetBrains.gitignore trata la carpeta .idea que comparten IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Rider, CLion y Android Studio. La plantilla no excluye .idea entera, sino que selecciona y bloquea solo el estado personal, la información sensible y los archivos generados automáticamente.
La guía oficial de JetBrains también recomienda compartir la configuración útil para el equipo, como el estilo de código, las configuraciones de ejecución y los perfiles de inspección, y excluir archivos personales como workspace.xml.
Explicación regla por regla
| Patrón | Qué ignora y por qué |
|---|---|
.idea/**/workspace.xml.idea/**/tasks.xml.idea/**/usage.statistics.xml.idea/**/dictionaries.idea/**/shelf | Estado de trabajo personalSon los archivos abiertos, la posición del cursor, el historial de tareas, el diccionario personal y los cambios guardados con shelve. Varían según la persona y cambian a menudo. |
.idea/**/dataSources/.idea/**/dataSources.local.xml.idea/**/sqlDataSources.xml.idea/**/dynamic.xml.idea/**/dbnavigator.xml | Conexiones a bases de datosSon la información de conexión y la caché de esquemas de las herramientas de bases de datos. La configuración de conexión local contiene información personal como el nombre de usuario. |
.idea/**/gradle.xml.idea/**/libraries | Resultados de sincronización con herramientas de compilaciónSon la configuración y la lista de bibliotecas que el IDE vuelve a crear al importar proyectos Gradle o Maven. |
out/*.iws.idea_modules/cmake-build-*/ | Salida del IDE y formatos heredadosSon la salida de compilación de IntelliJ, los archivos de espacio de trabajo del antiguo formato de proyecto basado en archivos y las carpetas de compilación CMake de CLion. |
atlassian-ide-plugin.xml.idea/sonarlint/com_crashlytics_export_strings.xmlcrashlytics.propertiesfabric.properties | Archivos de pluginsSon la configuración y las cachés que crean los plugins de JIRA, SonarLint y Crashlytics. |
.idea/httpRequestshttp-client.private.env.json | Secretos del cliente HTTPSon el historial de solicitudes del cliente HTTP integrado y el archivo de entorno privado donde se ponen tokens y contraseñas. Los valores públicos se ponen en http-client.env.json y se confirman. |
.idea/caches/build_file_checksums.ser.idea/**/contentModel.xml.idea/**/aws.xml | CachésSon la caché de sumas de verificación de archivos de compilación de Android Studio, modelos generados automáticamente y la configuración personal de AWS Toolkit. |
Precauciones en la práctica
- Si usas la importación automática de Gradle o Maven, descomentar las reglas
.idea/modules.xml,.idea/*.imly*.imlque aparecen en los comentarios de la plantilla reduce los cambios. - Si no necesitas compartir configuración, también puedes poner
.idea/en el gitignore global. En ese caso, esta plantilla no hace falta. - Si
.idea/workspace.xmlya está confirmado, sigue rastreándose aunque añadas la regla. Límpialo congit rm --cached .idea/workspace.xml.
Plantilla original
# Covers JetBrains IDEs: IntelliJ, GoLand, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839# User-specific stuff.idea/**/workspace.xml.idea/**/tasks.xml.idea/**/usage.statistics.xml.idea/**/dictionaries.idea/**/shelf# AWS User-specific.idea/**/aws.xml# Generated files.idea/**/contentModel.xml# Sensitive or high-churn files.idea/**/dataSources/.idea/**/dataSources.ids.idea/**/dataSources.local.xml.idea/**/sqlDataSources.xml.idea/**/dynamic.xml.idea/**/uiDesigner.xml.idea/**/dbnavigator.xml# Gradle.idea/**/gradle.xml.idea/**/libraries# Gradle and Maven with auto-import# When using Gradle or Maven with auto-import, you should exclude module files,# since they will be recreated, and may cause churn. Uncomment if using# auto-import.# .idea/artifacts# .idea/compiler.xml# .idea/jarRepositories.xml# .idea/modules.xml# .idea/*.iml# .idea/modules# *.iml# *.ipr# CMakecmake-build-*/# Mongo Explorer plugin.idea/**/mongoSettings.xml# File-based project format*.iws# IntelliJout/# mpeltonen/sbt-idea plugin.idea_modules/# JIRA pluginatlassian-ide-plugin.xml# Cursive Clojure plugin.idea/replstate.xml# SonarLint plugin.idea/sonarlint/# see https://community.sonarsource.com/t/is-the-file-idea-idea-idea-sonarlint-xml-intended-to-be-under-source-control/121119.idea/sonarlint.xml# Crashlytics plugin (for Android Studio and IntelliJ)com_crashlytics_export_strings.xmlcrashlytics.propertiescrashlytics-build.propertiesfabric.properties# Editor-based HTTP Client.idea/httpRequestshttp-client.private.env.json# Android studio 3.1+ serialized cache file.idea/caches/build_file_checksums.ser# Apifox Helper cache.idea/.cache/.Apifox_Helper.idea/ApifoxUploaderProjectSetting.xml# Github Copilot persisted session migrations, see: https://github.com/microsoft/copilot-intellij-feedback/issues/712#issuecomment-3322062215.idea/**/copilot.data.migration.*.xml
Origen de las plantillas: github/gitignore/Global/JetBrains.gitignore @356fd7b (2026-09-11) · CC0-1.0