Leer en inglés

Compartir a través de


dotnet format

Este artículo se aplica a: ✔️ SDK de .NET 6.x y versiones posteriores

Nombre

dotnet format: Da formato al código para que coincida con el valor editorconfig.

Sinopsis

CLI de .NET
dotnet format [<PROJECT | SOLUTION>] [command] [options]

dotnet format -h|--help

Descripción

dotnet format es un formateador de código que aplica preferencias de estilo y recomendaciones de análisis estático a un proyecto o solución. Las preferencias se leerán de un archivo .editorconfig, si están presentes; de lo contrario, se usará un conjunto predeterminado de preferencias. Para más información, consulte la documentación de EditorConfig.

Argumentos

PROJECT | SOLUTION

El proyecto o solución de MSBuild donde se ejecutará el formato de código. Si no se especifica un archivo de proyecto o solución, MSBuild busca en el directorio de trabajo actual un archivo que tenga una extensión de archivo que termine en proj o sln y lo usa.

Opciones

Ninguna de las opciones siguientes es necesaria para que el comando dotnet format se ejecute correctamente, pero se pueden usar para personalizar aún más lo que se formatea y con qué reglas.

  • --diagnostics <DIAGNOSTICS>

    Lista separada por espacios de identificadores de diagnóstico que se usarán como filtro al corregir problemas de estilo de código o de terceros. El valor predeterminado es cualquier identificador que aparezca en el archivo .editorconfig. Para ver una lista de los identificadores de reglas de analizador integrados que puede especificar, consulte la lista de identificadores de las reglas de estilo de análisis del código.

  • --severity

    Gravedad mínima de los diagnósticos que se corregirán. Los valores permitidos son info, warn y error. El valor predeterminado es warn.

  • --no-restore

    No ejecuta una restauración implícita antes del formato. El valor predeterminado es realizar una restauración implícita.

  • --verify-no-changes

    Comprueba que no se realizarían cambios de formato. Finaliza con un código de salida distinto de cero si se hubiera dado formato a algún archivo.

  • --include <INCLUDE>

    Lista separada por espacios de rutas de acceso relativas a archivos o carpetas que se incluirán en el formato. El valor predeterminado son todos los archivos de la solución o el proyecto.

  • --exclude <EXCLUDE>

    Lista separada por espacios de rutas de acceso relativas a archivos o carpetas que se excluirán del formato. El valor predeterminado es none.

  • --include-generated

    Da formato a los archivos generados por el SDK.

  • -v|--verbosity <LEVEL>

    Establece el nivel de detalle. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed] y diag[nostic]. El valor predeterminado es m[inimal].

  • --binarylog <BINARY-LOG-PATH>

    Registra toda la información de carga del proyecto o solución en un archivo de registro binario.

  • --report <REPORT-PATH>

    Genera un informe JSON en el directorio especificado por <REPORT_PATH>.

  • -h|--help

    Muestra información de ayuda y uso

Subcomandos

Espacio en blanco

dotnet format whitespace: Da formato al código para que coincida con el valor editorconfig para el espacio en blanco.

Descripción

El dotnet format whitespace subcomando solo ejecuta reglas de formato asociadas al formato de espacio en blanco. Para ver una lista completa de las posibles opciones de formato que puede especificar en el archivo .editorconfig, consulte las opciones de formato de C#.

Opciones

  • --folder

    Trate el argumento <PROJECT | SOLUTION> como una ruta a una carpeta simple de archivos de código.

Estilo

dotnet format style: Da formato al código para que coincida con el valor EditorConfig para el estilo de código.

Descripción

El dotnet format style subcomando solo ejecuta reglas de formato asociadas al formato de estilo de código. Para ver una lista completa de las posibles opciones de formato que puede especificar en el archivo editorconfig, consulte Reglas de estilo de código.

Opciones

  • --diagnostics <DIAGNOSTICS>

    Lista separada por espacios de identificadores de diagnóstico que se usarán como filtro al corregir problemas de estilo de código. El valor predeterminado es cualquier identificador que aparezca en el archivo .editorconfig. Para obtener una lista de identificadores de regla de analizador de estilo de código integrados que puede especificar, consulte la lista de identificadores para reglas de estilo de análisis de código.

  • --severity

    Gravedad mínima de los diagnósticos que se corregirán. Los valores permitidos son info, warn y error. El valor predeterminado es warn

Analizadores

dotnet format analyzers : da formato al código para que coincida editorconfig con la configuración de los analizadores (excepto las reglas de estilo de código).

Descripción

El dotnet format analyzers subcomando solo ejecuta reglas de formato asociadas a los analizadores. Para obtener una lista de reglas de analizador que puede especificar en el editorconfig archivo, consulte Reglas de calidad.

Opciones
  • --diagnostics <DIAGNOSTICS>

    Lista separada por espacios de identificadores de diagnóstico que se usarán como filtro al corregir problemas de estilo que no son de código. El valor predeterminado es cualquier identificador que aparezca en el archivo .editorconfig. Para obtener una lista de identificadores de regla de analizador integrados que puede especificar, consulte la lista de identificadores para las reglas de calidad. Para los analizadores de terceros, consulte su documentación.

  • --severity

    Gravedad mínima de los diagnósticos que se corregirán. Los valores permitidos son info, warn y error. El valor predeterminado es warn.

Ejemplos

  • Dar formato a todo el código de la solución:

    CLI de .NET
    dotnet format ./solution.sln
    
  • Limpiar todo el código del proyecto de aplicación:

    CLI de .NET
    dotnet format ./src/application.csproj
    
  • Comprobar que todo el código tiene el formato correcto:

    CLI de .NET
    dotnet format --verify-no-changes
    
  • Limpiar todo el código del directorio src y tests, pero no en src/submodule-a:

    CLI de .NET
    dotnet format --include ./src/ ./tests/ --exclude ./src/submodule-a/
    
  • Corrija un problema de estilo de código específico:

    CLI de .NET
    dotnet format style --diagnostics IDE0005 --severity info
    
  • Corrija todos los problemas de estilo de código que tienen gravedad infoo warning error:

    CLI de .NET
    dotnet format style --severity info
    
  • Corrija un problema específico del analizador (sin estilo de código):

    CLI de .NET
    dotnet format analyzers --diagnostics CA1831 --severity warn
    
  • Corrija todos los problemas de estilo que no son de código que tengan gravedad infoo warning error:

    CLI de .NET
    dotnet format analyzers --severity info