Un álbum de fotos se le enseña a la familia, se copia, se presta. Por eso hay cosas que no se fotografían: la combinación de la caja fuerte no se pega entre las fotos del cumpleaños. En tu carpeta pasa lo mismo. Tarde o temprano vas a guardar ahí una clave, la de un servicio de IA para tu página o la del wifi del local, y git add . la metería en la próxima foto sin preguntar. Esta última parada cierra esa puerta y deja la barbería lista para construir.
Dos claves sueltas en la carpeta
En la barbería aparecieron .env, con la clave de un servicio de IA, y claves.txt, con la del wifi:
$ git statusEn la rama masterArchivos sin seguimiento: (usa "git add <archivo>..." para incluirlo a lo que será confirmado) .env claves.txtno hay nada agregado al commit pero hay archivos sin seguimiento presentes (usa "git add" para hacerles seguimiento)
$ git statusOn branch masterUntracked files: (use "git add <file>..." to include in what will be committed) .env claves.txtnothing added to commit but untracked files present (use "git add" to track)
git las ve como archivos nuevos, listos para la mesa.
Que estén «sin seguimiento» quiere decir que ninguna foto las tiene todavía. Bien. El problema es el próximo git add .: las pondría sobre la mesa junto con todo lo demás. Una vez dentro de una foto, una clave se queda en el álbum aunque después borres el archivo, y el álbum se copia y se comparte. Cómo guardar bien una clave, fuera de los archivos del proyecto, está en variables de entorno y API keys, sin llorar. Esta parada se ocupa de que, si alguna queda en la carpeta, git no la fotografíe nunca.
La lista de lo que no sale
La caja fuerte es un archivo de texto con un nombre exacto, .gitignore, en la carpeta del proyecto. Cada renglón es un nombre que git debe ignorar. El de la barbería tiene dos renglones, claves.txt y .env, y nada más.
Créalo con tu editor, como creaste PROYECTO.md en el sendero anterior:
$ code .gitignore# escribe los dos renglones en el editor, guarda y vuelve a la terminal
El punto al principio es parte del nombre, y por ese punto el archivo queda oculto en el Finder y en el Explorador; no te asustes si no lo ves.
También puedes pedírselo a tu copiloto: abre Claude en la carpeta y escríbele «crea un archivo .gitignore con dos renglones: claves.txt y .env». Lee el diálogo de permiso antes de aceptar, como siempre.
En Windows, no lo crees con > desde PowerShell 5.1, el que trae Windows: lo probamos, guarda el archivo en una codificación que git no lee, y git sigue viendo las claves sin avisar nada. En PowerShell 7 no pasa.
Comprueba que git ya no las ve
Con el .gitignore en su sitio, pregunta otra vez. Este paso no te lo saltes:
$ git statusEn la rama masterArchivos sin seguimiento: (usa "git add <archivo>..." para incluirlo a lo que será confirmado) .gitignoreno hay nada agregado al commit pero hay archivos sin seguimiento presentes (usa "git add" para hacerles seguimiento)$ git check-ignore -v claves.txt.gitignore:1:claves.txt claves.txt$ git check-ignore -v .env.gitignore:2:.env .env$ git check-ignore -v PROYECTO.md
$ git statusOn branch masterUntracked files: (use "git add <file>..." to include in what will be committed) .gitignorenothing added to commit but untracked files present (use "git add" to track)$ git check-ignore -v claves.txt.gitignore:1:claves.txt claves.txt$ git check-ignore -v .env.gitignore:2:.env .env
Las claves desaparecieron de la lista. Solo queda el .gitignore, que sí va en la foto.
Los archivos siguen en tu carpeta, intactos: git solo dejó de mirarlos. git check-ignore -v te dice por qué ignora un archivo. Se lee así: en .gitignore, renglón 1, la regla claves.txt atrapa a claves.txt. Para PROYECTO.md no contesta nada, que es la respuesta buena: ese archivo sí entra en las fotos. Si git status todavía muestra tus claves, el .gitignore quedó mal guardado: revisa el nombre y vuelve a crearlo.
Y aunque insistas
Fotografías la lista y después intentas meter una clave a propósito:
$ git add .$ git statusEn la rama masterCambios a ser confirmados: (usa "git restore --staged <archivo>..." para sacar del área de stage) nuevos archivos: .gitignore$ git commit -m "gitignore: las claves no salen en la foto"[master 5a988dc] gitignore: las claves no salen en la foto 1 file changed, 2 insertions(+) create mode 100644 .gitignore$ git add claves.txtLas siguientes rutas son ignoradas por uno de tus archivos .gitignore:claves.txthint: Use -f if you really want to add them.hint: Disable this message with "git config set advice.addIgnoredFile false"
$ git add .# el mismo aviso de CRLF de antes, recortado$ git statusOn branch masterChanges to be committed: (use "git restore --staged <file>..." to unstage) new file: .gitignore$ git commit -m "gitignore: las claves no salen en la foto"[master fa491d4] gitignore: las claves no salen en la foto 1 file changed, 2 insertions(+) create mode 100644 .gitignore$ git add claves.txtThe following paths are ignored by one of your .gitignore files:claves.txthint: Use -f if you really want to add them.hint: Disable this message with "git config set advice.addIgnoredFile false"
git add . ya no las toca, y pedirla por su nombre tampoco funciona.
El mensaje dice que claves.txt está en la lista de ignorados y que, si de verdad quieres meterlo, existe -f, de «forzar». No lo uses con una clave. Ahora git add . vuelve a ser cómodo y seguro a la vez: pone en la mesa todo lo que cambió, menos lo de la caja fuerte. Cada vez que aparezca en la carpeta un archivo que no debe viajar, una clave nueva o un archivo que solo te sirve a ti, agrégale un renglón al .gitignore y saca una foto de ese cambio.
Si la clave ya salió en una foto
Pasa. Supón que en otra carpeta claves.txt entró en una foto antes de que existiera el .gitignore. Agregarlo al .gitignore no basta: git sigue vigilando un archivo que ya salió en una foto. Lo sacas de las próximas fotos y fotografías la lista. Esto pasó en otra carpeta; no lo corras en la barbería:
$ git rm --cached claves.txtrm 'claves.txt'$ git add .gitignore$ git commit -m "saca claves.txt de las fotos"[master 3e0ca77] saca claves.txt de las fotos 2 files changed, 2 insertions(+), 1 deletion(-) create mode 100644 .gitignore delete mode 100644 claves.txt$ git show HEAD~1:claves.txtclave del wifi: utileria
La foto anterior todavía guarda la clave, y cualquiera con el álbum la puede leer.
git rm --cached saca el archivo de las fotos que vienen y lo deja en tu carpeta. Pero el álbum no se despega, y eso, que hasta ahora era tu red de seguridad, aquí juega en contra: git show HEAD~1:claves.txt abre la foto anterior y muestra la clave tal cual. Borrarla de la historia se puede, pero es delicado y no hace falta para lo que sigue. La salida que siempre funciona es otra: da esa clave por perdida y cámbiala. Entras al servicio, generas una clave nueva y anulas la vieja.
El ritmo: cuándo sacar la foto
Con git, la pregunta deja de ser cómo y pasa a ser cuándo. Saca una foto cada vez que algo quedó bien y lo leíste en el diff. Antes de pedirle a tu copiloto un cambio grande, para tener un «antes» limpio. Y al cerrar cada sesión, después de que Claude actualice el estado. Las notas, en la forma que ya conoces: qué cambió, en una frase que entiendas sin abrir la foto. Si dudas, saca la foto.
Tu álbum, listo para construir
Así queda la barbería al final del sendero:
$ git log --oneline5a988dc (HEAD -> master) gitignore: las claves no salen en la foto7bf313e Revert "ofertas de los martes"9247f9d ofertas de los martes924a2a3 formas de pago en PROYECTO.md1d2939b sube el corte a 9 dólares208bb41 notas sueltas02d43a4 horario en PROYECTO.md19e9720 datos reales de la barberíacba69c9 proyecto descrito y archivos de manejo
Nueve fotos, cada una con su nota, y la caja fuerte cerrada.
Lees este álbum de abajo hacia arriba y es la historia del proyecto: lo describiste, cargaste los datos, sumaste el horario, subiste un precio, tu copiloto escribió las formas de pago, alguien agregó ofertas que se anularon, y las claves quedaron fuera. Ningún archivo se llama _v2. Con esto tienes las ideas de git que vas a usar todos los días: mirar, preparar la mesa, sacar la foto, leer el diff y volver atrás. Lo demás, que es mucho, puede esperar hasta que lo necesites.
En el próximo sendero construyes tu página, con una foto a cada paso: la página de la barbería, con cinco pedidos a tu copiloto y su diff leído antes de cada foto. Mientras tanto, el mapa completo está en los senderos.
