Windows 安装 .NET 8 SDK（含运行时与 dotnet CLI）
winget install Microsoft.DotNet.SDK.8C# / .NET 开发环境配置 - 码剑客
配置 .NET 开发环境：SDK 安装与版本固定、全局工具、NuGet 换源、工程模板创建、调试与常见报错排查。
.NET 8 LTS更新于 2026-10-29共 28 条
安装与版本管理
macOS 用 Homebrew、Ubuntu 用官方源安装 SDK
# macOS
brew install --cask dotnet-sdk
# Ubuntu / Debian
sudo apt update && sudo apt install -y dotnet-sdk-8.0分别列出已安装的 SDK 与运行时，排查版本不匹配时最关键
dotnet --list-sdks
dotnet --list-runtimes在仓库根目录写入 global.json，锁定团队使用的 SDK 版本
dotnet new globaljson --sdk-version 8.0.301 --force查看并安装工作负载（如 MAUI、Blazor WebAssembly）
dotnet workload list
dotnet workload install maui镜像源与代理
添加国内 NuGet 源，安装包时优先使用
dotnet nuget add source https://mirrors.huaweicloud.com/repository/nuget/v3/index.json -n huaweicloud查看当前启用的源与优先级
dotnet nuget list source国内网络下先禁用官方源，避免超时拖慢还原；需要时再启用
dotnet nuget disable source nuget.org接入公司私有源并保存凭据，注意明文存储的取舍
dotnet nuget add source https://nuget.example.com/v3/index.json -n corp -u user -p password --store-password-in-clear-text代理环境下让 dotnet restore 走代理；macOS/Linux 用 export
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890环境变量
确认命令行实际使用的 dotnet 来自哪个安装目录
# Windows
where dotnet
# macOS / Linux
which -a dotnet某些 IDE 与自宿主程序依赖 DOTNET_ROOT 定位运行时
# Windows PowerShell
[Environment]::SetEnvironmentVariable("DOTNET_ROOT", "C:\Program Files\dotnet", "Machine")
# macOS / Linux
echo 'export DOTNET_ROOT=/usr/share/dotnet' >> ~/.zshrc设置 ASP.NET Core 运行环境，本地调试用 Development
# Windows
setx ASPNETCORE_ENVIRONMENT Development
# macOS / Linux
export ASPNETCORE_ENVIRONMENT=Development设置 DOTNET_CLI_TELEMETRY_OPTOUT=1 可关闭 CLI 遥测
echo %DOTNET_CLI_TELEMETRY_OPTOUT%创建工程与验证
一次性查看 SDK、运行时、RID 与配置路径
dotnet --info创建 Web API 工程并启动，浏览器访问终端输出的地址
dotnet new webapi -o demo --use-controllers
cd demo
dotnet run创建控制台工程验证基础工具链可用
dotnet new console -o hello
cd hello
dotnet run发布为目标平台产物，自包含会显著增大体积
dotnet build -c Release
dotnet publish -c Release -r linux-x64 --self-contained false运行解决方案内的全部测试项目
dotnet test编辑器与插件
安装 C# 扩展与官方开发套件（调试、测试、热重载）
code --install-extension ms-dotnettools.csharp
code --install-extension ms-dotnettools.csdevkitWindows 安装 Visual Studio 社区版；macOS 可用 Rider 替代
winget install Microsoft.VisualStudio.2022.Community安装 EF Core 迁移工具等全局 CLI 工具
dotnet tool install -g dotnet-ef
dotnet tool list -g常见问题排查
报 SDK 或运行时版本不匹配时，先确认本机实际装了哪些版本
dotnet --list-sdks
dotnet --list-runtimes关闭增量构建并输出详细日志，定位编译失败原因
dotnet build --no-incremental -v nNuGet 包缓存损坏时清理本地全部缓存后重新还原
dotnet nuget locals all --clear工作负载安装损坏导致模板或构建失败时修复
dotnet workload repair本机 HTTPS 证书不受信任导致浏览器告警时，重新生成并信任开发证书
dotnet dev-certs https --trust默认端口被占用导致启动失败时定位占用进程
netstat -ano | findstr :5000