dotnet

.NET SDK 命令行

补充说明

dotnet 是 .NET SDK 的统一入口，负责创建项目、还原依赖、构建、测试和发布。SDK 版本与目标运行时版本不是一回事，多版本共存时要看 global.json。

常用示例

dotnet --info
dotnet new console -o app
dotnet restore
dotnet build -c Release
dotnet run --project app
dotnet test
dotnet add package Newtonsoft.Json
dotnet publish -c Release -o out
dotnet publish -c Release -r linux-x64 --self-contained true
dotnet tool install -g dotnet-ef
dotnet ef migrations add Init
dotnet nuget locals all --list

易错点与排错

• 机器可以同时装多个 SDK；global.json 会把项目固定到某个版本。
• 发布产物默认是框架依赖；目标机需要对应运行时，除非 --self-contained。
• -r 指定 RID 后，依赖和原生库要匹配；跨平台发布要确认目标 RID。
• NuGet 缓存损坏会导致还原失败；用 dotnet nuget locals all --clear 清理后重试。
• 私有源配置在 NuGet.config；认证信息不要提交。
• dotnet run 会先构建，适合开发；生产部署用 publish 产物。
• 工具（tool）和项目依赖是两套管理方式；全局工具要单独升级。
• ASP.NET Core 的端口、环境变量和反向代理配置不要只靠默认值。

相关命令

• nuget — 包管理
• docker — 容器化发布