历史文章重制版

解决Hugo安装后命令不可用的问题

在Windows上使用winget安装Hugo后，命令提示'hugo不是内部或外部命令'的解决方案。

HTML 版式Claude 风中性色

导读

在Windows上使用winget安装Hugo后，命令提示'hugo不是内部或外部命令'的解决方案。

阅读建议

如果你只想快速抓重点，可以先看每个章节的标题、列表和代码块，再决定是否细读完整过程。

问题描述

使用winget安装Hugo Extended后，在新的终端窗口执行 hugo version 提示：

'hugo' 不是内部或外部命令，也不是可运行的程序或批处理文件。

原因分析

winget安装Hugo后会修改用户PATH环境变量，但当前终端会话不会自动刷新PATH。

解决方案

方案1：重新打开终端（推荐）

关闭当前终端，重新打开一个新的PowerShell或CMD窗口。

方案2：手动刷新PATH

在PowerShell中执行：

$env:Path = [Environment]::GetEnvironmentVariable("Path", "User") + ";" + [Environment]::GetEnvironmentVariable("Path", "Machine")

方案3：使用完整路径

找到Hugo安装路径，直接执行：

# 默认安装路径
    & "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\Hugo.Hugo.Extended_Microsoft.Winget.Source_8wekyb3d8bbwe\hugo.exe" version

验证安装

hugo version
    # 应输出: hugo v0.163.1+extended windows/amd64

经验总结

  1. 1Windows包管理器安装软件后，通常需要重启终端

    Windows包管理器安装软件后，通常需要重启终端

  2. 2使用 winget list hugo 可以确认是否已安装

    使用 winget list hugo 可以确认是否已安装

  3. 3Hugo需要Extended版本才能支持PaperMod主题的SCSS

    Hugo需要Extended版本才能支持PaperMod主题的SCSS