Visualización y comprensión de archivos

GitHub proporciona herramientas para ver contenido sin procesar, realizar un seguimiento de los cambios en líneas específicas y explorar cómo ha evolucionado el contenido de un archivo con el tiempo. Esta información revela cómo se desarrolló el código, su propósito actual y su estructura, lo que ayuda a que tu contribución resulte eficaz.

Visualización o copia del contenido del archivo sin formato

Con la vista sin formato, puede ver o copiar el contenido sin formato de un archivo sin ningún estilo.

1. En GitHub, navegue hasta la página principal del repositorio.

2. Haga clic en el archivo que quiera ver.

3. En la esquina superior derecha de la vista de archivo, haga clic en Raw.

   

4. Opcionalmente, para copiar el contenido del archivo sin procesar, en la esquina superior derecha de la vista de archivos, haz clic en . Para descargar el archivo sin formato, haz clic en .

Visualización del historial de revisiones línea a línea de un archivo

Dentro de la vista de último responsable, puedes ver el historial de revisiones línea a línea de un archivo completo.

1. En GitHub, navegue hasta la página principal del repositorio.

2. Haz clic para abrir el archivo cuyo historial de líneas quieres ver.

3. Encima del contenido del archivo, haz clic en Último responsable. Esta vista muestra un historial de revisiones línea a línea, con el código del archivo separado por confirmaciones. Se indica el autor, la descripción y la fecha de cada confirmación.

4. Para ver las versiones de un archivo antes de una confirmación concreta, haz clic en . Como alternativa, para ver más detalles sobre una confirmación determinada, haga clic en el mensaje de confirmación.

   

5. Para volver a la vista de código sin procesar, encima del contenido del archivo, haga clic en Código.

   • Si está visualizando un archivo Markdown, encima del contenido del archivo, también puede hacer clic en Vista previa para volver a la vista con el formato Markdown aplicado.

Omisión de las confirmaciones en la vista de último responsable

Todas las revisiones especificadas en el archivo .git-blame-ignore-revs, que debe estar en el directorio raíz del repositorio, se ocultan de la vista de último responsable mediante el valor de configuración git blame --ignore-revs-file de Git. Para más información, vea git blame --ignore-revs-file en la documentación de Git.

1. En el directorio raíz del repositorio, cree un archivo con el nombre .git-blame-ignore-revs.

2. Agregue a ese archivo los hash de confirmación que quiera excluir de la vista de último responsable. Se recomienda estructurar el archivo de la siguiente manera, incluidos los comentarios:

   # .git-blame-ignore-revs
   # Removed semi-colons from the entire codebase
   a8940f7fbddf7fad9d7d50014d4e8d46baf30592
   # Converted all JavaScript to TypeScript
   69d029cec8337c616552756310748c4a507bd75a
   

3. Confirme e inserte los cambios.

Ahora, cuando visite la vista de último responsable, las revisiones enumeradas no se incluirán. Verá un banner Ignoring revisions in .git-blame-ignore-revs (Omitir revisiones en .git-blame-ignore-revs) que indica que algunas confirmaciones pueden estar ocultas:

Este archivo puede ser útil cuando algunas confirmaciones realizan cambios exhaustivos en el código. También puede usar el archivo al ejecutar git blame localmente:

git blame --ignore-revs-file .git-blame-ignore-revs

También puedes configurar el repositorio Git local para que siempre omita las revisiones de ese archivo:

git config blame.ignoreRevsFile .git-blame-ignore-revs

Omisión de .git-blame-ignore-revs en la vista de último responsable

Si la vista de último responsable de un archivo muestra Ignorando revisiones de .git-blame-ignore-revs, todavía puedes omitir .git-blame-ignore-revs y ver la vista de último responsable normal. En la dirección URL, anexa ~ al SHA y el banner Omitir revisionesen .git-blame-ignore-revs desaparecerá.

Comprensión de archivos con Copilot

También puedes usar Copilot para preguntar sobre líneas de código específicas de un archivo, lo que ayuda a comprender cómo funciona el código y a reducir el riesgo de introducir nuevos problemas.

1. En GitHub, vaya a un repositorio y abra un archivo.

2. Realice una de las siguientes acciones:

   • Para hacer una pregunta sobre el archivo entero, haz clic en el icono Copilot () de la parte superior derecha de la vista del archivo.

     

   • Para hacer una pregunta sobre líneas específicas dentro del archivo:

     1. Haz clic en el número de línea de la primera línea que quieras seleccionar, mantén presionada la tecla Mayúsculas y, a continuación, haz clic en el número de línea de la última línea que quieras seleccionar.
     2. Para hacer tu propia pregunta sobre las líneas seleccionadas, haz clic en el icono Copilot () a la derecha de la selección y escribe tu pregunta en el panel GitHub Copilot Chat.
     3. Para hacer una pregunta predefinida, haz clic en el menú desplegable situado junto al icono Copilot y elige una de las opciones.
     

3. Si haces clic en el icono Copilot , escribe una pregunta en el cuadro “Pregunta Copilot” situado en la parte inferior del panel de chat y presiona Entrar.

   Por ejemplo, si pregunta por el archivo completo, puede escribir:

   • Explain this file.
   • How could I improve this code?
   • How can I test this script?

   Si pregunta por líneas específicas, puede escribir:

   • Explain the function at the selected lines.
   • How could I improve this class?
   • Add error handling to this code.
   • Write a unit test for this method.

   Copilot responde a tu solicitud en el panel.

4. Opcionalmente, después de enviar una pregunta, puedes hacer clic en en el cuadro de texto para detener la respuesta.

5. Puede continuar la conversación con una pregunta de seguimiento. Por ejemplo, puede escribir “dime más” para que Copilot amplíe su último comentario.