Resolución de un bloqueo en la solicitud de extracción

          GitHub Code Quality está actualmente en versión preliminar pública y estará disponible con carácter general el 20 de julio de 2026.

Durante versión preliminar pública, Code Quality no se facturará, aunque los análisis de Code Quality consumirán GitHub Actions minutos. A partir del 20 de julio de 2026, el uso incurrirá en cargos. Consulte GitHub Code Quality facturación.

Comprender por qué está bloqueado el pull request

Los administradores del repositorio pueden establecer puertas de calidad mediante GitHub Code Quality. Al abrir una solicitud de incorporación de cambios, las comprobaciones se ejecutan automáticamente para evaluar los cambios con respecto a estos estándares.

Hay dos tipos de bloques:

• Resultados de calidad del código: los cambios presentan problemas que se encuentran por debajo del umbral de calidad necesario.
• Umbral de cobertura: los cambios hacen que la cobertura de código se encuentre por debajo de un mínimo necesario o haga que la cobertura se quite por más de una cantidad permitida en relación con la rama predeterminada.

Si la solicitud de incorporación de cambios introduce código que está por debajo del umbral de calidad necesario, verá un banner de bloque de combinación en la parte inferior de la solicitud de incorporación de cambios en la sección "Comprobaciones": "La combinación está bloqueada: se detectaron resultados de calidad del código".

Estas comprobaciones ayudan a mantener un código base saludable y fácil de mantener y evitar que la deuda técnica se acumula.

Visualización de los resultados del examen y sus niveles de gravedad

Los resultados del análisis se notifican como comentarios en su solicitud de incorporación de cambios, que deja github-code-quality[bot]. Cada comentario corresponde a un problema de calidad de código específico que se detectó en los cambios.

Los comentarios se etiquetan por gravedad (Error, Advertencia, Nota). Para más información sobre lo que significan los niveles de gravedad, consulte Niveles de gravedad.

Determinar qué hallazgos bloquean la solicitud de incorporación de cambios

La puerta de calidad establecida por los administradores del repositorio define el nivel de gravedad mínimo que bloqueará la combinación.

El banner del bloque de mezcla puede especificar el nivel de gravedad mínimo. Todos los resultados en ese nivel de gravedad o superior deben abordarse antes de poder fusionar la solicitud de incorporación de cambios.

Corregir o descartar cada hallazgo

Para desbloquear la solicitud de incorporación de cambios, usted debe resolver cada observación requerida al decidir si corregir el problema en su código o descartar el comentario.

Aprovechamiento de Autofijo de Copilot y agente en la nube de Copilot para corregir hallazgos

Autofijo de Copilot

Los comentarios de la solicitud de incorporación de cambios incluyen un autofix sugerido que puede confirmar directamente en su solicitud. Revise cuidadosamente la corrección automática sugerida en cuanto a lógica, seguridad y estilo, luego haga clic en Confirmar sugerencia.

No necesita una licencia Copilot para aplicar estas sugerencias.

agente en la nube de Copilot

Como alternativa, si tiene una Copilot licencia, puede delegar el trabajo de corrección en agente en la nube de Copilot. Haga un comentario en la solicitud de incorporación de cambios mencionando @Copilot y solicite que Copilot corrija los problemas detectados.

Copilot responde con un emoji de ojos (👀) a tu comentario, inicia una nueva sesión del agente y abre un pull request con las correcciones necesarias.

Puede hacer seguimiento del trabajo de agente en la nube de Copilot.

• En el pull request, el resumen se actualiza conforme avanza el trabajo.
• Utilizando la página de agentes o los registros de sesión: consulte Gestión de sesiones del agente.

Necesita una Copilot licencia para invocar agente en la nube de Copilot.
Regístrese para Copilot

Descartar el hallazgo

Puede descartar una búsqueda si no es relevante o procesable en el contexto de su código base. Entre las razones comunes para descartar un hallazgo se incluyen:

• El hallazgo está en el código heredado que ya no se mantiene.
• Es una excepción conocida a los estándares de codificación de su equipo.
• Es un falso positivo que no supone un riesgo real de calidad.

Descartar alertas irrelevantes mantiene las comprobaciones de calidad centradas en problemas significativos.

Comprobación de que ha cumplido los requisitos

Para ver si ha cumplido los requisitos de calidad del código, consulte la sección "Comprobaciones" en la parte inferior de la solicitud de incorporación de cambios. El banner del bloque de combinación ya no debería estar presente, y debería poder fusionar sus cambios como siempre.

Resolver un bloqueo por umbral de cobertura

Si tu pull request está bloqueada por una regla de umbral de cobertura, verás un aviso de bloqueo de fusión en la sección "Checks" con un mensaje que indica qué umbral no se alcanzó. Por ejemplo:

• "La cobertura del 22,0 % es inferior al mínimo del 50,0 %": la cobertura de ramas de tu solicitud de incorporación de cambios está por debajo del porcentaje mínimo de cobertura configurado en el conjunto de reglas.
• "La cobertura disminuyó en 2,5%, la caída máxima permitida es de 1,0%": los cambios provocaron que la cobertura bajase por más de la cantidad permitida en relación con la rama predeterminada.

Para desbloquear la solicitud de incorporación de cambios, debe agregar o modificar pruebas para que se ejecute más del código base:

1. Revise el comentario de resumen de cobertura en la solicitud de incorporación de cambios para identificar qué archivos o áreas carecen de cobertura.
2. Agregue o actualice pruebas para aumentar la cobertura de ejecución.
3. Inserte los cambios. La comprobación de cobertura se volverá a ejecutar automáticamente.

Pasos siguientes

Reduzca la deuda técnica mediante la corrección de los hallazgos en archivos modificados recientemente. Consulta Mejora de la calidad de código combinado recientemente con IA.