Solución de problemas

La mayoría de los fallos de build se relacionan con el entorno TeX o paquetes faltantes. Esta guía aborda los problemas comunes y sus soluciones por síntoma.

Comandos de diagnóstico

Abra Terminal y ejecute:

which lualatex which latexmk which latexindent which synctex

Compruebe también en TeX64: Ajustes > Entorno para verificar el estado del entorno

Problemas del entorno TeX

«latexmk not found»

Causa: Distribución TeX no instalada o ausente de PATH

Solución:

  • Instale MacTeX desde https://www.tug.org/mactex/
  • O: sudo tlmgr install latexmk
  • Verificar: which latexmk
  • Reinicie TeX64 tras la instalación

«lualatex not found»

Causa: Distribución TeX no instalada

Solución: Instale MacTeX (incluye lualatex)

«latexindent not found»

Solución:

sudo tlmgr install latexindent

Nota: latexindent es opcional (para formateo de código), el build funciona sin él

«synctex not found»

Solución: incluido en MacTeX por defecto, o: sudo tlmgr install synctex

Sin synctex, la navegación SyncTeX no funcionará

Paquete .sty faltante

Error: «File xxx.sty not found»

Solución:

sudo tlmgr install <package-name>

Para buscar:

tlmgr search --global --file <filename>

Problemas con PATH

Comprobar: echo $PATH

Debe incluir /Library/TeX/texbin para MacTeX o /opt/homebrew/bin para Homebrew

Solución: Añada a ~/.zshrc: export PATH="/Library/TeX/texbin:$PATH"

Reinicie Terminal y TeX64

Problemas de build

El build falla con errores

Revise el panel de salida del build para ver los mensajes de error. Haga clic en el error para saltar a la línea fuente.

Causas comunes: erratas en comandos LaTeX, llaves descompensadas, paquetes faltantes

Consejo: use la IA (Axiom) para diagnosticar: pegue el error o pregunte en el chat

El PDF no se actualiza

El PDF solo se actualiza con builds EXITOSOS. Revise la salida del build en busca de errores.

Reconstruya con el botón de build de la barra de herramientas.

El build es lento

Los proyectos grandes con muchas imágenes tardan más.

latexmk usa compilación incremental: los builds posteriores son más rápidos.

El primer build puede ser lento debido a la descarga de paquetes

Problemas de SyncTeX

SyncTeX no funciona

Verifique que synctex esté instalado: which synctex

Reconstruya el proyecto con el botón de build de la barra de herramientas para generar el archivo .synctex.gz

Verifique la marca verde en Ajustes > Entorno

SyncTeX salta a una ubicación incorrecta

Algunos paquetes LaTeX interfieren con el mapeo de la fuente

Proyectos multiarchivo: asegúrese de que las rutas \input/\include sean correctas

Problemas de macOS

Gatekeeper

Control+clic (clic derecho) → Abrir O: Ajustes del Sistema > Privacidad y seguridad > Permitir

Permiso de Grabación de Pantalla (para OCR)

Ajustes del Sistema > Privacidad y seguridad > Grabación de pantalla > activar TeX64

Es posible que deba reiniciar TeX64 tras conceder el permiso

«App is Damaged»

Descargue de nuevo el DMG. Verifique la arquitectura correcta (Apple Silicon vs Intel)

Problemas de IA/Axiom

Funciones de IA no disponibles

Asegúrese de haber iniciado sesión y compruebe su cuenta: Cuenta > Facturación

La IA (chat y autocompletado) se incluye en todos los planes, incluida una pequeña prueba mensual en el plan Gratuito. El motivo más habitual de que deje de funcionar es que se haya agotado la cuota mensual de tokens (o que un pago esté pendiente): recargue o espere al siguiente ciclo.

Compruebe la cuota de tokens: Cuenta > Uso

Verifique la conexión a Internet

Respuestas de IA lentas o expiración

Compruebe la conexión a Internet

El servidor puede estar saturado: vuelva a intentarlo en un momento

Límite de tasa: 30 solicitudes/minuto

Cuenta e inicio de sesión

Falla el inicio de sesión con Google

Compruebe la conexión a Internet. Pruebe borrando cookies/caché del navegador. Vuelva a iniciar sesión.

La suscripción no se refleja

Los cambios de facturación pueden tardar unos minutos

Si el pago falló, actualice el método de pago en el portal de facturación de Stripe

Período de gracia: 3 días tras el fallo del pago antes de desactivar funciones

Problemas de la Galería

Límites de publicaciones: Free=10, Basic=100, Pro=500

Límite diario: 10 publicaciones al día

Tamaño de imagen: 20 MB máx. Fuente TeX: 500 000 caracteres máx. Etiquetas: 8 máx por publicación.

Obtener ayuda

Use el chat de IA para describir los problemas (puede leer los registros de compilación)

Contacte con soporte en /feedback

Incluya: versión de macOS, versión de TeX64, mensaje de error, pasos para reproducir

El diagnóstico opcional de errores se puede activar en Ajustes > Privacidad

Consejo: Al diagnosticar problemas de build, comience ejecutando los comandos de diagnóstico para verificar la configuración de su entorno TeX. La mayoría de los problemas provienen del entorno.