StyLua impone un único estilo de código Lua determinista en todos los proyectos
Formatea el código fuente de Lua en un estilo determinista a partir de un AST analizado, produciendo la misma salida independientemente del espaciado o los saltos de línea originales. Creado por JohnnyMorganz para el desarrollo de escritorio, la herramienta está dirigida a proyectos de Lua, Luau y LuaJIT e integra a nivel de editor o CI. Ofrece integración LSP, una CLI con modos de verificación y diferencia, y configuración TOML por proyecto, lo que la hace adecuada para desarrolladores y creadores de Roblox que necesitan un formateo predecible y automatizado.
Qué hace y quién se beneficia
StyLua reescribe el código Lua a partir de una representación analizada, por lo que los archivos siguen un estilo único y opinativo después del formateo. Soporta múltiples dialectos de Lua, incluyendo Luau y LuaJIT, y expone una CLI además de soporte para el Protocolo de Lenguaje del Servidor para la integración en editores. Los equipos que desean un estilo único impuesto pueden agregar un archivo TOML a nivel de proyecto o .editorconfig para definir la indentación, el ancho de columna y las preferencias de comillas.
Cómo interactúa con los sistemas de desarrollo
La herramienta está diseñada para ejecuciones rápidas y repetibles en flujos de trabajo locales y automatizados. Su implementación en Rust produce un formateo de baja latencia adecuado para acciones de editor al guardar o trabajos a nivel de repositorio. Proporciona modos de verificación y diferencia para CI, y soporta .styluaignore para excluir rutas. El formateo por rango limita las ediciones a regiones de código seleccionadas, lo que reduce el cambio en archivos grandes durante ediciones incrementales.
Seguridad, configuración y facilidad de uso
StyLua opera de manera determinista y ofrece ganchos de editor para reducir pasos manuales. La opción LSP proporciona formateo en tiempo real dentro de editores compatibles, mientras que las banderas de CLI permiten verificar el estilo sin cambiar archivos. La configuración a través de stylua.toml mantiene las reglas en la raíz del proyecto, y los archivos de ignorar previenen reescrituras no intencionadas. Los usuarios con experiencia mínima en Lua pueden confiar en los valores predeterminados; los usuarios avanzados pueden ajustar las reglas a través del esquema TOML.
Recomendado para equipos que necesitan formateo automático y repetible de Lua
StyLua es adecuado para desarrolladores y creadores de Roblox que requieren un formateo consistente en una base de código y herramientas rápidas para flujos de trabajo de editores o CI. Espere un esfuerzo de configuración único para que coincida con su estilo preferido, luego automatice el formateo como un paso previo al commit o CI para hacer cumplir esto. Recomendado.
