Visualización y comprensión de archivos

Explora los cambios de contenido y seguimiento de archivos a lo largo del tiempo para comprender el nuevo código base y su evolución.

En este artículo

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.

    Captura de pantalla de un archivo. En el encabezado, un botón, con la etiqueta "Sin procesar", está resaltado en naranja oscuro.

  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.

Tip

En la línea de comandos, también puedes usar git blame para ver el historial de revisiones de líneas dentro de un archivo. Para más información, vea la documentación de git blame de Git.

  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.

    Captura de pantalla de una confirmación en la vista de último responsable. El mensaje de confirmación y el icono de versiones se describen en naranja oscuro.

  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:

Captura de pantalla de la vista de culpa del archivo "ipc-main-internal.ts". Un banner azul indica que la información es "Omitir revisiones en .git-blame-ignore-revs". El vínculo al archivo .git-blame-ignore-revs se destaca en naranja oscuro.

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á.