Si Git sigue listando un archivo aunque coincida con .gitignore, elimínelo del índice de Git conservando la copia local. En Terminal, vaya al repositorio, ejecute git rm --cached -- "path/to/file", luego haga commit de esa eliminación preparada y de la regla de exclusión. La documentación de Git confirma que las reglas de exclusión afectan a los archivos no rastreados; no dejan de rastrear archivos que ya están en el índice. (Documentación de gitignore de Git)

Por qué .gitignore no ha dejado de rastrear el archivo

Un patrón de .gitignore le indica a Git que ignore las rutas no rastreadas coincidentes. Si un archivo ya se había añadido al repositorio, Git continuará rastreando sus cambios sin importar una regla de exclusión posterior. La regla puede ser correcta y aun así parecer que no surte efecto hasta que elimine ese archivo del índice. (Documentación de gitignore de Git)

En Mac, abra Terminal y cámbiese a la carpeta principal del repositorio. Apple documenta Terminal como la interfaz de línea de comandos de macOS e identifica a zsh como el shell predeterminado; los comandos a continuación funcionan en la configuración habitual de zsh. Confirme que está en el repositorio correcto antes de modificar su índice:

git status

La ruta del archivo en el siguiente comando es relativa a la raíz del repositorio. Reemplace el ejemplo por la ruta real. Mantenga las comillas: protegen los espacios y caracteres como * para que no sean interpretados por el shell. El -- marca el final de las opciones, por lo que una ruta que comience con un guion se tratará como una ruta.

Eliminar el archivo del índice y conservar la copia de Mac

Ejecute:

git rm --cached -- "path/to/file"

--cached elimina la ruta del índice de Git, no del árbol de trabajo. El archivo debería permanecer en su Mac. Esto prepara una eliminación para el siguiente commit; no borra el historial de commits anteriores del archivo. (Documentación de git rm de Git)

Si la ruta está dentro de un directorio y su intención es dejar de rastrear todo el directorio, agregue -r y use su ruta:

git rm --cached -r -- "path/to/directory"

Use esto con cuidado: Git elimina del índice todas las rutas rastreadas bajo ese directorio. Los archivos locales se conservan, pero la eliminación queda en el área de preparación (stage). Si Git se niega porque el archivo tiene cambios en stage o su contenido difiere de la versión en el último commit, deténgase e inspeccione git status; no agregue -f a menos que comprenda qué cambios en stage se descartarían. Git documenta la opción de forzar como una anulación de su protección habitual para dichos cambios. (Documentación de git rm de Git)

Comprobar la regla de exclusión y revisar lo que se incluirá en el commit

Asegúrese de que el patrón de .gitignore coincida con la ruta desde la ubicación de ese archivo de exclusión. Por ejemplo, una regla en el .gitignore de la raíz del repositorio que contenga local-settings.json coincidirá con archivos que tengan ese nombre en cualquier nivel de directorio; /local-settings.json restringe la coincidencia a la raíz del repositorio. Los patrones de Git son relativos al directorio que contiene el .gitignore, y los archivos de exclusión más específicos en niveles inferiores pueden influir en el resultado. (Documentación de gitignore de Git)

Pregúntele a Git qué regla coincide con el archivo que ahora no está rastreado:

git check-ignore -v -- "path/to/file"

La opción -v muestra el origen y el patrón responsable. Si esto no imprime nada, revise nuevamente la ortografía, la ruta y la ubicación del patrón. Las preguntas frecuentes (FAQ) de Git recomiendan git rm --cached junto con un patrón de exclusión coincidente para dejar de rastrear e ignorar un archivo que ya estaba rastreado. (Git FAQ)

Revise el cambio preparado y la copia de trabajo antes de hacer commit:

git status

El estado debería mostrar la ruta preparada como eliminada y .gitignore como modificado si su cambio aún no está en stage. El archivo de trabajo aún debería estar presente. Añada al stage el archivo de exclusión si es necesario, luego haga commit de ambos cambios:

git add -- .gitignore
git commit -m "Stop tracking local file"

Si el archivo de exclusión correspondiente está en un subdirectorio, use su ruta relativa al repositorio en git add. Revise git status nuevamente antes de hacer commit, especialmente si hay otro trabajo en stage, para que el commit contenga únicamente los cambios deseados.

Qué sucede después del commit

Después del commit, Git ya no rastrea esa ruta en la rama actual, y la regla de exclusión evita que se vuelva a agregar por accidente. El commit registra una eliminación, por lo que los colaboradores que hagan checkout de ese commit verán el archivo rastreado eliminado de su árbol de trabajo; Git no preserva automáticamente la copia local ignorada de cada persona. Coordine antes de hacer el commit si el archivo contiene configuraciones compartidas que sus compañeros de equipo aún necesiten. Las versiones commiteadas previamente permanecen en el historial del repositorio, por lo que este procedimiento no elimina las copias pasadas. (Documentación de git rm de Git)

Si su intención era únicamente ocultar ediciones locales mientras mantiene el archivo rastreado para todos los demás, .gitignore no es el mecanismo adecuado. Git desaconseja el uso de assume-unchanged o skip-worktree para ese propósito; en su lugar, considere una plantilla rastreada y un archivo de configuración local independiente e ignorado. (Git FAQ)

Fuentes