Solución de problemas de la CLI

Resuelve los problemas de selección de archivos, estado de referencia, recogida de resultados y catálogos sin borrar primero información de estado útil.

Ten a mano la versión instalada, el comando, el directorio de trabajo, el error y las rutas afectadas mientras diagnosticas un fallo. Oculta las credenciales antes de compartir los registros: los diagnósticos de inicio y de fallos pueden incluir argv sin filtrar.

No hay archivos de origen que coincidan con #

Busca el .lingo/config.json más cercano. Un comando ejecutado en un subdirectorio puede usar el proyecto de un directorio superior. Comprueba include antes que pattern, porque incluso una regla de inclusión vacía tiene prioridad sobre este último. Las exclusiones se aplican a cada entrada; otra entrada puede seguir seleccionando el mismo archivo.

Usa una sintaxis de coincidencia compatible, como docs/en/**/*, escribe los patrones de shell entre comillas y comprueba qué sufijos se admiten. Para YAML, debes indicar explícitamente yaml, yaml-root-key o yaml-openapi; para Android XML, android. Un archivo .txt, .csv o .properties necesita un patrón que termine en su extensión, o bien "format": "txt", "format": "csv" o "format": "properties"; un patrón genérico como docs/en/**/* lo omite, y una entrada txt, csv o properties omite todos los archivos que no tengan esa extensión. Especificar un formato explícitamente no hace que se admitan todas las extensiones.

La salida se guardó en el lugar equivocado #

Lee las advertencias sobre cómo se calcula la ruta y compara el destino con el cargador de tu aplicación. Si no se reconoce ningún segmento del idioma de origen, define targetPath y sourceRoot en lugar de recurrir a la inserción del idioma como alternativa. Mantén los archivos de destino fuera de la búsqueda de archivos de origen y comprueba si hay colisiones.

Mover los archivos no basta para actualizar el estado de referencia. XCStrings utiliza un único catálogo de origen compartido por diseño; no sigue la estructura habitual de archivos separados por idioma. Consulta rutas de salida.

Una opción no tiene efecto #

Las claves desconocidas en la raíz o en las entradas de archivo generan advertencias y se ignoran. Comprueba que estén bien escritas y que el procesador seleccionado admita esas opciones. Los ajustes de las rutas del catálogo no actualizan los patrones de push, y extract y check establecen, cada uno por su cuenta, en como idioma de origen predeterminado.

La puntuación local utiliza el ejecutable lingo.config.ts, no el JSON del proyecto. Una opción de protección de JSON no controla necesariamente Markdown ni otros formatos.

Falta un artefacto del estado de referencia #

El artefacto de origen anterior identificado por el hash del Lockfile debe existir en local o en el servidor. Inspecciona la entrada indicada y recupera los bytes de una versión que sepas que es correcta o un estado de referencia coherente. No inventes un hash ni borres todo el Lockfile para ocultar el error.

Si falta información de estado, un primer push normal almacena los bytes de origen; para los archivos de destino convencionales que falten, hay que ejecutar el proceso de generación de archivos ausentes. Lockfile y caché explica qué registro necesita la operación.

pull indica un conflicto #

Ejecuta lingo pull --dry-run para inspeccionar las decisiones de escritura. Un archivo de destino que difiera de la salida del servidor, de los bytes capturados al ejecutar push y del hash del Lockfile bloquea las escrituras. Incluirlo en un commit no cambia la comparación.

Conserva los cambios y resuelve las diferencias, restaura una versión conocida o usa la opción de forzado solo si quieres reemplazar el contenido deliberadamente. No edites los archivos de destino durante push --wait, ya que no realiza la comprobación de conflictos con datos actualizados que hace pull.

El trabajo ha fallado o sigue incompleto #

Inspecciona los errores de cada destino y distingue entre trabajo pendiente, revisión, fallos y salidas ausentes. Si una ejecución falla, push --wait y pull terminan con un código distinto de cero después de escribir los documentos completados; comprueba el estado y los archivos reales.

Cuando todos los destinos sin terminar están pendientes de revisión humana, push --wait y pull dejan de esperar y lo indican. Los documentos con todos sus idiomas completados se pueden recoger; vuelve a ejecutar lingo pull cuando quienes realizan la revisión hayan terminado. Ejecutar otro push no resuelve la espera de una revisión.

Si la ejecución ha fallado, corrige la causa indicada y repite el comando adecuado para ese trabajo. Para las actualizaciones habituales del origen, usa lingo push --wait sin modificar el origen y conservando el estado de referencia. Si faltan archivos de destino, repite el proceso de generación de archivos ausentes solo cuando los destinos existentes estén actualizados, siguiendo Añadir un idioma. No hace falta modificar el origen, usar una opción de forzado ni eliminar el estado para solicitar otro intento.

push muestra el ID del trabajo que envía o al que vuelve a vincularse. Si no se recogieron los resultados del push anterior y la solicitud no ha cambiado, push reutiliza esa solicitud: un trabajo que sigue en ejecución conserva su ID, y uno fallido se sustituye por un trabajo nuevo. Conserva el ID del trabajo fallido y confirma que la siguiente línea Job que aparezca muestre un ID diferente. Eso identifica un nuevo envío, no una traducción completada correctamente: inspecciona los resultados de cada destino, recupera la salida y revisa las diferencias. Mantén los archivos de destino locales sin cambios durante --wait; si necesitas proteger los cambios locales, ejecuta push y pull por separado, con la comprobación de conflictos de pull.

Si el cliente instalado devuelve el mismo trabajo fallido, deja de repetir los envíos y escribe a support@lingo.dev. Incluye la versión de la CLI, el comando sin datos sensibles, el ID de la ejecución anterior y el de la devuelta, la revisión del origen, los idiomas y las rutas afectados, las marcas de tiempo y el error sin datos sensibles. No incluyas credenciales, texto privado del origen ni archivos de credenciales sin filtrar en el mensaje. Conserva el puntero de ejecución local y el Lockfile mientras se investiga el fallo.

Eliminar el puntero de ejecución no es una forma fiable de solicitar una nueva traducción; mientras no se recojan los resultados de un push, el puntero conserva la identidad de la solicitud que evita los envíos duplicados. Si no se encuentra ninguna ejecución, comprueba el equipo, la ruta absoluta de la raíz del proyecto y si otro push ha sustituido el puntero.

Fallan las comprobaciones del catálogo #

Ejecuta extract con el mismo idioma y las mismas rutas que check. Inspecciona las advertencias sobre llamadas dinámicas o desestructuradas antes de eliminar las entradas huérfanas. Solo se informa de que falta un archivo de destino cuando los patrones de files coinciden con el catálogo de origen; de lo contrario, compara los idiomas esperados con los archivos existentes.

Elimina únicamente las entradas cuya retirada sea intencionada, regenera las declaraciones y, después, ejecuta check y compila la aplicación. status se ha trasladado a check; los nombres de los servicios internos no son comandos ejecutables.

Antes de eliminar nada #

Purgar muestra una vista previa de la eliminación de archivos de destino. Los filtros de archivos e idiomas limitan la eliminación a los destinos seleccionados y a sus entradas en el Lockfile; una purga sin filtros elimina todo el Lockfile. Los catálogos compartidos de XCStrings se omiten. Usa purge cuando tu intención sea eliminar contenido. La mayoría de las tareas de recuperación necesitan una corrección concreta que conserve la redacción aceptada y el estado recuperable.