Repolode
astral-sh

astral-sh/ruff

Un linter y formateador de código Python ultrarrápido, escrito en Rust, con más de 900 reglas de lint y formato compatible con Black.

Alternativa open source a:BlackFlake8

Estrellas
50,197
Forks
2,534
Issues abiertos
2,220
Último commit
hace 4 horas

¿Qué es?

Ruff es un linter y formateador de código Python escrito en Rust. Detecta errores, problemas de estilo y patrones obsoletos, y puede corregir muchos de ellos automáticamente. Está diseñado para reemplazar una combinación de herramientas como Flake8 con sus plugins, Black, isort, pydocstyle y pyupgrade, ejecutándolas con un solo comando y una configuración compartida.

El linter incluye más de 900 reglas, muchas de las cuales reimplementan en Rust, de forma nativa, plugins populares de Flake8. Las reglas se activan mediante pyproject.toml, ruff.toml o .ruff.toml, y se puede usar un conjunto predeterminado sin configuración. La caché integrada omite los archivos que no han cambiado desde la última ejecución.

Ruff se puede instalar con pip, uv, pipx, Homebrew y Conda, e incluye integraciones para editores como una extensión de VS Code, hooks de pre-commit y una GitHub Action. Su configuración admite la detección jerárquica para monorepos.

Funciones clave

  • 01Analiza código Python con más de 900 reglas, muchas de las cuales reimplementan plugins de Flake8
  • 02Formatea código con un formateador compatible con Black
  • 03Corrige automáticamente muchos de los problemas detectados con --fix
  • 04Guarda los resultados en caché para omitir los archivos que no han cambiado
  • 05Se configura mediante pyproject.toml o ruff.toml, con detección jerárquica de la configuración

Casos de uso

  • Reemplazar Flake8, Black e isort por una sola herramienta en un proyecto Python
  • Ejecutar comprobaciones de lint y formato como hook de pre-commit o en CI
  • Analizar rápidamente un monorepo grande con configuración por directorio
  • Recibir sugerencias del editor y aplicar correcciones automáticas en VS Code y otros editores

Inicio rápido

  1. 1

    Instala Ruff con uv (recomendado)

    uv tool install ruff@latest
  2. 2

    Instala Ruff con pip

    pip install ruff
  3. 3

    Analiza todos los archivos del directorio actual

    ruff check
  4. 4

    Da formato a todos los archivos del directorio actual

    ruff format

Temas

Preguntas frecuentes

¿Qué es ruff?
Un linter y formateador de código Python ultrarrápido, escrito en Rust, con más de 900 reglas de lint y formato compatible con Black. Ruff es un linter y formateador de código Python escrito en Rust. Detecta errores, problemas de estilo y patrones obsoletos, y puede corregir muchos de ellos automáticamente. Está diseñado para reemplazar una combinación de herramientas como Flake8 con sus plugins, Black, isort, pydocstyle y pyupgrade, ejecutándolas con un solo comando y una configuración compartida.
¿ruff es gratuito? ¿Qué licencia tiene?
ruff es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ruff sigue mantenido?
Mantenimiento activo. El último commit de ruff fue el 21 oct 2026.
¿Para qué puedo usar ruff?
Reemplazar Flake8, Black e isort por una sola herramienta en un proyecto Python Ejecutar comprobaciones de lint y formato como hook de pre-commit o en CI Analizar rápidamente un monorepo grande con configuración por directorio Recibir sugerencias del editor y aplicar correcciones automáticas en VS Code y otros editores
¿Cómo se instala ruff?
Instala Ruff con uv (recomendado): uv tool install ruff@latest Instala Ruff con pip: pip install ruff Analiza todos los archivos del directorio actual: ruff check Da formato a todos los archivos del directorio actual: ruff format
¿Dónde consigo ruff?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/astral-sh/ruff

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados