Hay una situaci\u00f3n muy com\u00fan al trabajar con Git: quieres que un archivo deje de formar parte del repositorio, pero no quieres borrarlo de tu ordenador. Esto pasa, por ejemplo, con archivos de configuraci\u00f3n local, credenciales, ficheros generados autom\u00e1ticamente o documentos que ya no deber\u00edan versionarse.<\/p>\n
La buena noticia es que Git permite hacer justo eso. No necesitas eliminar el archivo del disco duro para quitarlo del control de versiones. En este art\u00edculo ver\u00e1s c\u00f3mo hacerlo de forma segura, cu\u00e1ndo usar cada comando y qu\u00e9 ocurre exactamente en el \u00edndice del repositorio.<\/p>\n
Cuando hablamos de eliminar un archivo del repositorio, en realidad nos referimos a sacarlo del \u00e1rea de staging<\/strong> y del historial futuro del proyecto, no necesariamente a borrarlo del sistema de archivos. Es decir, el archivo puede seguir existiendo en tu m\u00e1quina, pero Git dejar\u00e1 de rastrearlo en adelante.<\/p>\n Este matiz es importante porque Git trabaja con tres zonas clave: el directorio de trabajo, el staging area y el historial del repositorio. Si conoces esa diferencia, entender\u00e1s por qu\u00e9 algunos comandos eliminan el archivo de verdad y otros solo lo desindexan. Si necesitas repasar esta base, te puede venir bien el art\u00edculo sobre c\u00f3mo a\u00f1adir archivos al repositorio con git add<\/a>, ya que explica el flujo inverso.<\/p>\n El comando m\u00e1s \u00fatil en este caso es git rm –cached<\/strong>. Con \u00e9l le indicas a Git que deje de seguir un archivo, pero sin borrarlo f\u00edsicamente del disco. Es una soluci\u00f3n ideal cuando quieres que algo deje de versionarse, pero necesitas conservarlo localmente.<\/p>\n Tras ejecutar el comando, Git marcar\u00e1 el archivo como eliminado del repositorio en el pr\u00f3ximo commit. Si luego haces git commit<\/strong>, ese fichero dejar\u00e1 de seguirse desde ese punto en adelante, aunque seguir\u00e1 estando en tu equipo.<\/p>\n Si quieres repasar c\u00f3mo se registra ese cambio en el historial, puedes consultar el art\u00edculo sobre c\u00f3mo crear un commit correctamente con git commit<\/a>.<\/p>\n Es f\u00e1cil confundir git rm<\/strong> con git rm –cached<\/strong>. Ambos parecen parecidos, pero no hacen lo mismo. El primero elimina el archivo del disco y del repositorio, mientras que el segundo solo lo saca de la indexaci\u00f3n de Git.<\/p>\n Se usa cuando quieres borrar por completo un archivo del proyecto, tanto localmente como del control de versiones. Es \u00fatil para ficheros obsoletos, duplicados o definitivamente innecesarios.<\/p>\n Se usa cuando el archivo debe seguir existiendo en tu m\u00e1quina, pero ya no debe formar parte del repositorio. Esta opci\u00f3n es muy habitual en entornos de desarrollo con archivos locales sensibles o variables de entorno.<\/p>\n Si ya has a\u00f1adido el archivo antes y quieres entender mejor qu\u00e9 est\u00e1 ocurriendo en la zona de preparaci\u00f3n, recuerda que git status<\/a> es el comando m\u00e1s \u00fatil para comprobar la situaci\u00f3n antes de confirmar nada.<\/p>\n Muchos proyectos tienen archivos como .env<\/strong>, ficheros de configuraci\u00f3n IDE o ajustes personalizados que no deber\u00edan compartirse con todo el equipo. En esos casos, normalmente conviene dejar de rastrearlos y a\u00f1adirlos al archivo .gitignore<\/strong>.<\/p>\n Primero eliminas el archivo del \u00edndice con Hay proyectos que crean carpetas de compilaci\u00f3n, logs, cach\u00e9s o assets temporales. Estos elementos suelen pertenecer al entorno local y no al repositorio. Si ya se a\u00f1adieron por error, puedes desindexarlos y evitar que ensucien el historial.<\/p>\n Si un archivo con credenciales lleg\u00f3 a Git, quitarlo del repositorio no basta por s\u00ed solo para resolver el problema de seguridad. Debes adem\u00e1s revisar el historial, rotar claves y, si es necesario, reescribir referencias sensibles. Para este tipo de escenarios, conviene conocer herramientas como git revert<\/a> o incluso t\u00e9cnicas m\u00e1s avanzadas como las explicadas en c\u00f3mo borrar un commit del historial de Git<\/a>, siempre con mucho cuidado.<\/p>\n El proceso es sencillo, pero conviene hacerlo con orden para no perder informaci\u00f3n ni mezclar cambios innecesarios.<\/p>\n Si trabajas con una carpeta completa, puedes usar la opci\u00f3n recursiva. Es muy pr\u00e1ctica cuando necesitas dejar fuera varios ficheros a la vez, por ejemplo en un directorio de builds o logs.<\/p>\n Una vez desindexado, Git deber\u00eda dejar de seguir el archivo, pero a veces sigue apareciendo porque no se ha a\u00f1adido a .gitignore<\/strong>. Si ese paso falta, el fichero volver\u00e1 a mostrarse cuando cambie su contenido.<\/p>\n Tambi\u00e9n puede ocurrir que el archivo siga formando parte del historial anterior. Eso es normal: quitarlo del seguimiento no borra autom\u00e1ticamente lo que ya se hab\u00eda confirmado en commits previos. Si necesitas auditar el historial, te puede servir revisar c\u00f3mo ver el historial de cambios con git log<\/a>.<\/p>\n Antes de sacar un archivo del repositorio, conviene hacer una peque\u00f1a revisi\u00f3n. Comprueba si ese fichero est\u00e1 compartido por el equipo, si contiene datos sensibles o si depende de \u00e9l alg\u00fan proceso de integraci\u00f3n continua.<\/p>\n Si el archivo forma parte de una rama activa o de una colaboraci\u00f3n en equipo, avisa antes de cambiar su estado de seguimiento. En flujos colaborativos, un cambio aparentemente peque\u00f1o puede afectar a despliegues, scripts o entornos de desarrollo.<\/p>\n Y si el archivo fue modificado recientemente, aseg\u00farate de no confundir esta operaci\u00f3n con otras acciones como deshacer cambios, restaurar contenido o mover commits. Son herramientas distintas con efectos distintos. Para no mezclar conceptos, puedes repasar art\u00edculos como c\u00f3mo recuperar archivos con git restore<\/a> y c\u00f3mo utilizar git reset correctamente<\/a>.<\/p>\n Uno de los errores m\u00e1s frecuentes es usar Otro error habitual es olvidar actualizar .gitignore<\/strong>. Sin esa exclusi\u00f3n, el archivo puede reaparecer en cuanto se modifique. Tambi\u00e9n es com\u00fan no revisar el estado del repositorio antes de confirmar, algo que puede evitarse f\u00e1cilmente con Eliminar archivos del repositorio sin borrarlos del disco es una de esas tareas que parecen complicadas hasta que entiendes el comportamiento del \u00edndice de Git. La clave est\u00e1 en usar git rm –cached<\/strong> para desindexar, a\u00f1adir el patr\u00f3n correspondiente a .gitignore<\/strong> y confirmar el cambio con un commit limpio.<\/p>\n Esta t\u00e9cnica te ayuda a mantener repositorios m\u00e1s ordenados, evitar la publicaci\u00f3n de archivos sensibles y separar mejor lo que pertenece al proyecto de lo que solo necesitas en tu m\u00e1quina. Si dominas este flujo, gestionar\u00e1s mucho mejor la limpieza y el control de versiones en proyectos reales.<\/p>\n Documentaci\u00f3n oficial de git rm<\/a><\/p>\nLa forma correcta: git rm con la opci\u00f3n –cached<\/h2>\n
# Quita el archivo del \u00edndice de Git, pero lo conserva en tu disco\ngit rm --cached archivo.txt\n\n# Si quieres aplicar el cambio a una carpeta completa\ngit rm -r --cached carpeta\/\n\n# Despu\u00e9s revisa el estado\ngit status\n<\/code><\/pre>\nDiferencia entre borrar el archivo y dejar de rastrearlo<\/h2>\n
git rm<\/h3>\n
git rm –cached<\/h3>\n
Casos de uso habituales<\/h2>\n
Archivos de configuraci\u00f3n local<\/h3>\n
git rm --cached<\/code> y despu\u00e9s lo ignoras para que no vuelva a aparecer en futuros commits. Si quieres profundizar en este paso, te recomendamos leer c\u00f3mo ignorar archivos con .gitignore<\/a>.<\/p>\nArchivos generados autom\u00e1ticamente<\/h3>\n
Secretos y credenciales<\/h3>\n
Paso a paso para quitar un archivo del repositorio sin borrarlo<\/h2>\n
# 1. Quita el archivo del seguimiento de Git\ngit rm --cached archivo.txt\n\n# 2. Verifica el cambio\ngit status\n\n# 3. A\u00f1ade el archivo a .gitignore si no quieres que vuelva a entrar\necho archivo.txt >> .gitignore\n\n# 4. Registra la modificaci\u00f3n\ngit add .gitignore\ngit commit -m \"Deja de rastrear archivo local\"\n<\/code><\/pre>\n# Quitar del \u00edndice todo el contenido de una carpeta\ngit rm -r --cached carpeta-temporal\/\n\n# Registrar la limpieza del repositorio\ngit add .\ngit commit -m \"Eliminar carpeta temporal del tracking\"\n<\/code><\/pre>\nQu\u00e9 hacer si el archivo sigue apareciendo en cambios futuros<\/h2>\n
Buenas pr\u00e1cticas antes de ejecutar el cambio<\/h2>\n
Errores comunes al intentar hacerlo<\/h2>\n
git rm archivo.txt<\/code> pensando que solo lo quitar\u00e1 del repositorio. En realidad, ese comando borra el archivo tambi\u00e9n del disco. Si tu intenci\u00f3n era conservarlo localmente, necesitas --cached<\/code>.<\/p>\ngit status<\/code>.<\/p>\nConclusi\u00f3n<\/h2>\n
Fuentes y lecturas recomendadas<\/h3>\n