dotnet new console -n myconsoleapp是最轻量可靠的创建方式，生成含.csproj和program.cs的项目，默认启用顶层语句；需显式结构时加--use-program-main，传参用dotnet run -- arg1 arg2。
直接用 dotnet new console 创建，别绕弯——这是当前最可靠、最轻量的启动方式，不需要 Visual Studio，也不依赖 GUI 工具链。
dotnet new console 命令的实际用法
在终端（PowerShell、CMD 或 VS Code 终端）中执行：
dotnet new console -n MyConsoleApp
这会生成一个标准项目结构：含 MyConsoleApp.csproj 和 Program.cs。注意两点：
-
-n后的项目名不能含空格或特殊字符（如My-Console-App会失败） - 若提示
dotnet: command not found，说明 SDK 未装好或 PATH 没生效，重启终端或手动检查dotnet --version是否能输出版本号（推荐 .NET 8+）
Program.cs 为什么没写 class 和 Main？
因为 C# 12 默认启用顶层语句（top-level statements），Program.cs 里直接写 Console.WriteLine("Hello, World!"); 就行。它等价于编译器自动生成：
using System;
class Program
{
static void Main(string[] args) { ... }
}
但如果你需要以下任一能力，就必须显式写出完整结构：
- 定义自己的类或静态方法
- 使用
async Task Main（顶层语句不支持await直接写在文件顶层） - 处理命令行参数并做类型转换（比如
int.Parse(args[0])）时想加 try/catch 包裹
运行时传参和调试配置的区别
dotnet run 默认走 Debug 配置，适合开发验证；但如果你要测试发布行为（比如 IL trimming、AOT 编译效果），得加参数：
dotnet run --configuration Release
向程序传参要用双横杠分隔：
dotnet run -- hello world 123
这时 args 数组就是 ["hello", "world", "123"]。容易忽略的是：-- 必须紧挨着 run，不能写成 dotnet run --configuration Release -- ... —— 这样参数会被 dotnet 自己吃掉，不会透传给你的程序。
引用 NuGet 包不能靠“右键添加引用”
控制台项目没有“引用”节点可右键，必须手动编辑 .csproj 文件。例如加 Newtonsoft.Json：
<itemgroup><packagereference include="Newtonsoft.Json" version="13.0.3"></packagereference></itemgroup>
改完后不用手动 restore，下次 dotnet run 或 dotnet build 会自动触发 dotnet restore。但如果改了包版本又想立刻生效，可以主动执行 dotnet restore。
真正容易卡住的地方不是语法，而是环境状态：PATH 没刷新、SDK 版本混用、.csproj 改错位置、或者误把 -- 当成注释符号丢在命令末尾。跑不通时，先查 dotnet --list-sdks 和 ls（或 dir）确认当前目录和 SDK 状态，比反复重装工具更省时间。
