Windows Server 2022无头安装.NET 7 SDK后dotnet命令无法识别求助

问题根源 #

AWS Systems Manager的PowerShell会话不会自动刷新系统环境变量，即便重启实例，新会话也可能无法识别.NET安装后新增的PATH条目，导致dotnet命令找不到。

分步解决方案 #

1. 正确安装.NET 7 SDK并注入环境变量 #

使用官方脚本时指定全局安装目录（规避用户目录权限问题），同时手动刷新会话PATH：

# 下载.NET安装脚本
Invoke-WebRequest -Uri https://dot.net/v1/dotnet-install.ps1 -OutFile dotnet-install.ps1

# 安装.NET 7 SDK到全局目录
.\dotnet-install.ps1 -Channel 7.0 -InstallDir "C:\Program Files\dotnet" -Runtime dotnet-sdk

# 更新机器级PATH环境变量
$dotnetGlobalPath = "C:\Program Files\dotnet"
$machinePath = [Environment]::GetEnvironmentVariable("PATH", "Machine")
if (-not $machinePath.Contains($dotnetGlobalPath)) {
    [Environment]::SetEnvironmentVariable("PATH", "$machinePath;$dotnetGlobalPath", "Machine")
}

# 刷新当前会话的PATH，立即生效
$env:PATH = [Environment]::GetEnvironmentVariable("PATH", "Machine") + ";" + [Environment]::GetEnvironmentVariable("PATH", "User")

2. 安装并验证nbgv全局工具 #

安装后需手动将工具目录加入当前会话PATH，确保能直接调用：

# 安装nbgv全局工具
dotnet tool install -g nbgv

# 将全局工具路径临时加入当前会话PATH
$dotnetToolsPath = "$env:USERPROFILE\.dotnet\tools"
if (-not $env:PATH.Contains($dotnetToolsPath)) {
    $env:PATH += ";$dotnetToolsPath"
}

# 验证安装结果
nbgv --version

3. SSM执行脚本的注意事项 #

• 避免拆分脚本为多个SSM命令，确保安装.NET、刷新环境变量、安装nbgv在同一个会话中完成
• 若必须拆分，后续命令需先执行环境变量刷新步骤再调用dotnet或nbgv

核心要点 #

• 优先选择C:\Program Files\dotnet作为安装目录，减少权限和环境变量加载异常
• 手动刷新会话PATH是解决无头环境下命令找不到的关键
• 全局工具默认安装在用户目录的.dotnet\tools下，需临时加入当前会话PATH才能直接调用

内容的提问来源于stack exchange，提问作者Philip Pittle