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

**URL:** <https://www.shiqidu.com/t/topic/2115>\
**Category:** 开发调优\
**Tags:** 编程, 微软, 问与答, 开源软件\
**Created:** [2026 年11 月 16 日 11:09 UTC](https://www.shiqidu.com/t/topic/2115 "2026-11-16T11:09:44Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\
发布日期： [2026 年11 月 16 日 11:09 UTC](https://www.shiqidu.com/t/topic/2115/1 "2026-11-16T11:09:44Z")

</div>

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

Microsoft Learn 的 [.NET 入门](https://learn.microsoft.com/zh-cn/dotnet/core/get-started) 现在走的是「基于文件的应用」：在 `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](https://learn.microsoft.com/zh-cn/dotnet/core/tools/dotnet-new)。这一页标明适用于 .NET 6 SDK 及更高版本。命令会根据指定模板创建新的项目、配置文件或解决方案，背后调用的是模板引擎。创建 C# 控制台应用程序，官方例子就是：

```auto
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](http://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 控制台应用程序](https://learn.microsoft.com/zh-cn/dotnet/core/tutorials/create-console-app)。这篇同时提供 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` 跑一行试试？
