想用命令行跑一个小程序,.NET 官方怎么用 Dotnet new 把项目建起来?

想用命令行跑一个小的 .NET 程序,按官方文档用 dotnet new 把项目建起来并第一次运行。不是 Visual Studio 完整 IDE 教程。

Microsoft Learn 的 .NET 入门 现在走的是「基于文件的应用」:在 tutorials 文件夹里新建 hello-world.cs,写入 Console.WriteLine("Hello, World!");,再在终端把该文件夹设为当前目录后执行 dotnet hello-world.cs。官方的说明是,SDK 会自动编译这个 .cs 文件并直接运行,不需要项目文件(.csproj)或额外设置。这一页把这种写法定位成适合学习、试验和写小型实用工具。应用变大以后,通常改用基于项目的应用来组织代码、依赖项和配置。本机那条路径的先决条件里,页上写的是要安装 .NET 10 SDK,另外还要有 Visual Studio Code 和 C# DevKit。也可以改走 GitHub Codespaces,那就需要一个 GitHub 帐户,不必先在本机装 SDK。这里只转述页上列出的先决条件,不去推断现在该装哪一个修补版本。

同一页还把那行代码拆开讲过:Console 是内置类型,用来和文本控制台打交道。WriteLine 会写出一行并补换行符。引号里的内容就是会显示出来的字符串。分号标记语句结束。这些足以确认命令已经跑通,不必一上来先搭完整解决方案。

如果要按模板在磁盘上建一个真正的项目,就看命令参考 dotnet new。这一页标明适用于 .NET 6 SDK 及更高版本。命令会根据指定模板创建新的项目、配置文件或解决方案,背后调用的是模板引擎。创建 C# 控制台应用程序,官方例子就是:

dotnet new console

如果要改语言,可以用 -lang 或 --language。页里特意提醒:某些 shell 会把 # 当成特殊字符,这时要把语言参数括在引号里,例如 dotnet new console -lang "F#"。不想把文件直接铺在当前目录,可以用 -n / --name 指定输出名称(不写就用当前目录名),用 -o / --output 指定放置位置(默认仍是当前目录)。页里用 dotnet new classlib --framework "netstandard2.0" -o MyLibrary 演示过 -o,控制台模板也可以同样指定目录。目标框架用 -f / --framework 传入 TFM,页上的例子是 net6.0、net7.0-macos 这类名字,写进项目文件里。还没动手、只想看看命令会生成什么,可以加 --dry-run。输出目录里已有文件、模板又要覆盖时,需要 --force。

要查看本机已经装了哪些模板,运行 dotnet new list。在 NuGet.org 上搜模板,用 search 子命令。从 .NET 7 SDK 开始,原来的 --list、--search、--install、--uninstall 已经改成 list、search、install、uninstall 子命令,--update-apply 则改成 update。不要再把旧的长选项当成默认写法。需要看某个模板自己的选项时,用 dotnet new console -h。页里还写了,从 .NET 6 起,默认模板不会在实例化时做更新检查,要更新默认模板应安装 SDK 的修补程序版本。从已安装的模板包实例化时,仍可能检查包更新,不想检查可以用 --no-update-check(自 SDK 6.0.100 起可用)。

第一次运行可以对照教程 创建 .NET 控制台应用程序。这篇同时提供 Visual Studio、Visual Studio Code 和 GitHub Codespaces 几个入口,这里不把 Visual Studio 向导逐步点一遍。VS Code 那条路的先决条件写的是「最新的 .NET SDK」,再加上编辑器和 C# 开发套件。Windows 上也可以用页里提供的 WinGet 配置文件一次性安装这些组件,已装过的会被跳过。创建项目时,是在资源管理器里选「创建 .NET Project」,或用命令面板找到「.NET: 新建项目」。再选「控制台应用」,把项目命名为 HelloWorld。模板生成的 Program.cs 就是一行 Console.WriteLine("Hello, World!");,C# 模板用顶级语句调用这个方法。教程在编辑器里用「运行而不调试」(Ctrl+F5)做第一次运行,并提醒 Visual Studio Code 不会在生成或运行时自动保存,改完要先显式存盘。Codespaces 那条走的是基于文件的应用,终端命令是 dotnet HelloWorld.cs。命令参考页还写了:dotnet new、dotnet build、dotnet run、dotnet test、dotnet publish 和 dotnet pack 这些需要还原的命令会隐式执行还原,不必先单独跑 dotnet restore。

官方控制台教程后半会把程序改成询问名字并打印当前时间,那已经超出「把项目建起来并第一次运行」。你是打算直接 dotnet new console 建项目,还是先用 dotnet 某个.cs 跑一行试试?