dotnet new

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

NOMBRE

dotnet new: crea un nuevo proyecto, archivo de configuración o solución según la plantilla especificada.

Sinopsis

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [--no-update-check] [-o|--output <OUTPUT_DIRECTORY>] [Template options]

dotnet new -h|--help

Descripción

El comando dotnet new crea un proyecto de .NET u otros artefactos basados en una plantilla.

El comando llama al motor de plantillas para crear los artefactos en el disco basándose en las opciones y la plantilla especificadas.

Restauración implícita

No es necesario ejecutar dotnet restore porque lo ejecutan implícitamente todos los comandos que necesitan que se produzca una restauración, como dotnet new, dotnet build, dotnet run, dotnet test, dotnet publish y dotnet pack. Para deshabilitar la restauración implícita, use la opción --no-restore.

El comando dotnet restore sigue siendo válido en algunos escenarios donde tiene sentido realizar una restauración explícita, como las compilaciones de integración continua en Azure DevOps Services o en los sistemas de compilación que necesitan controlar explícitamente cuándo se produce la restauración.

Para obtener información sobre cómo administrar fuentes de NuGet, vea la documentación de dotnet restore.

Argumentos

• TEMPLATE

  La plantilla de la que se va a crear una instancia cuando se invoca el comando. Cada plantilla puede tener opciones específicas que puede pasar. Para obtener más información, vea Opciones de plantilla.

  Puede ejecutar dotnet new --list para ver una lista de todas las plantillas instaladas.

  A partir del SDK de .NET Core 3.0 y hasta el SDK de .NET Core 5.0.300, la CLI busca plantillas en NuGet.org cuando se invoca al comando dotnet new en las siguientes condiciones:

  • Si la CLI no encuentra ninguna coincidencia de plantilla al invocar dotnet new, ni siquiera parcial.
  • Si hay disponible una versión más reciente de la plantilla. En este caso, se crea el proyecto o el artefacto, pero la CLI le advierte de que hay una versión actualizada de la plantilla.

  A partir del SDK de .NET Core 5.0.300, se debe usar la opción --search para buscar plantillas en NuGet.org.

  En la tabla siguiente se muestran las plantillas que vienen preinstaladas con el SDK de .NET. El lenguaje predeterminado de la plantilla se muestra entre corchetes. Haga clic en el vínculo del nombre corto para ver las opciones específicas de la plantilla.

Opciones

• --dry-run

  Muestra un resumen de lo que sucedería si se ejecutara el comando determinado y el resultado fuera la creación de una plantilla. Disponible a partir del SDK de .NET Core 2.2.

• --force

  Fuerza la generación de contenido incluso aunque se vayan a cambiar los archivos existentes. Es necesario si la plantilla elegida invalidará los archivos existentes en el directorio de salida.

• -?|-h|--help

  Imprime la ayuda para el comando. Puede invocarse para el propio comando dotnet new o para cualquier plantilla. Por ejemplo: dotnet new mvc --help.

• -lang|--language {C#|F#|VB}

  El lenguaje de la plantilla que se va a crear. El lenguaje aceptado cambia según la plantilla (vea los valores predeterminados en la sección argumentos). No es válido para algunas plantillas.

  Nota

  Algunos shells interpretan # como un carácter especial. En esos casos, incluya el valor del parámetro de lenguaje entre comillas. Por ejemplo: dotnet new console -lang "F#".

• -n|--name <OUTPUT_NAME>

  El nombre de la salida creada. Si no se especifica ningún nombre, se usa el nombre del directorio actual.

• -no-update-check

  Deshabilita la comprobación de actualizaciones de paquetes de plantillas al crear instancias de una plantilla. Disponible a partir del SDK de .NET 6.0.100. Al crear instancias de la plantilla desde un paquete de plantillas que se instaló mediante dotnet new --install, dotnet new comprueba si hay una actualización para la plantilla. A partir de .NET 6, no se realizan comprobaciones de actualización para las plantillas predeterminadas de .NET. Para actualizar las plantillas predeterminadas de .NET, instale la versión de revisión del SDK de .NET.

• -o|--output <OUTPUT_DIRECTORY>

  La ubicación para colocar la salida generada. El valor predeterminado es el directorio actual.

Opciones de plantilla

Cada plantilla puede tener opciones adicionales definidas. Para obtener más información, vea Plantillas predeterminadas de .NET para dotnet new.

Ejemplos

• Creación de un proyecto de aplicación de consola de C#:

  dotnet new console
  

• Creación de un proyecto de aplicación de consola con F# en el directorio actual:

  dotnet new console --language "F#"
  

• Creación de un proyecto de biblioteca de clases de .NET Standard 2.0 en el directorio especificado:

  dotnet new classlib --framework "netstandard2.0" -o MyLibrary
  

• Creación de un proyecto MVC de ASP.NET Core C# en el directorio actual sin autenticación:

  dotnet new mvc -au None
  

• Creación de un proyecto de xUnit:

  dotnet new xunit
  

• Creación de un archivo global.json en el directorio actual al establecer la versión del SDK en 3.1.101:

  dotnet new globaljson --sdk-version 3.1.101
  

• Mostrar ayuda para la plantilla de aplicación de consola de C#:

  dotnet new console -h
  

• Mostrar ayuda para la plantilla de aplicación de consola de F#:

  dotnet new console --language "F#" -h
  

Vea también

• dotnet new --list, opción
• dotnet new --search, opción
• dotnet new --install, opción
• Plantillas predeterminadas de .NET para dotnet new
• Plantillas personalizadas para dotnet new
• Creación de una plantilla personalizada para dotnet new
• Repositorio de GitHub dotnet/dotnet-template-samples