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 .

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. En la esquina superior derecha de la vista del archivo, haga clic en Blame para abrir la vista del último responsable.

    Captura de pantalla que muestra el encabezado de un archivo. El botón "Último responsable" está resaltado en naranja oscuro.

  4. Para ver versiones anteriores de una línea concreta, o bien el último responsable, haz clic en hasta que hayas encontrado los cambios que te interese ver.

    Captura de pantalla de la vista "Último responsable" de un archivo. A la derecha de un mensaje de confirmación, el icono de versiones está resaltado en naranja oscuro.

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