Windows 装 Hugo 踩坑记

Mon, 17 Aug 2026 09:49:30 +0800

装 Hugo 的时候踩了三个坑：winget 装不上、PATH 加错、exe 被杀软清成 0 字节。过程记下来，下次换机器能少折腾。

坑一：winget 装不上，直接下二进制

先试 winget：

winget install Hugo.Hugo.Extended

报"打开源时失败"。winget 的源在海外，国内网络经常连不上，winget source reset --force 也救不回来。绕开包管理器，去 Hugo Releases 下 hugo_extended_0.165.0_windows-amd64.zip，解压出 hugo.exe，放到 D:\app\hugo_0.165.0_windows-amd64\。

选 Extended 版，后面用 SCSS 或模板特性才不卡。先验证文件本身没问题：

D:\app\hugo_0.165.0_windows-amd64\hugo.exe version

能输出版本号，说明文件是好的。

坑二：PATH 里加的是文件不是目录

把 hugo.exe 所在目录加进 PATH 后，hugo version 还是"不是内部或外部命令"。echo %Path% 一看，加进去的是：

D:\app\hugo_0.165.0_windows-amd64\hugo.exe

Windows 的 PATH 只认目录，不认文件。cmd 找 hugo.exe 时把这行当目录进去翻，里面当然没有。改成目录就行：

D:\app\hugo_0.165.0_windows-amd64

还有两个细节：

改完 PATH 必须新开终端，旧窗口不刷新
echo %Path% 是窗口打开那一刻的快照，GUI 改了旧窗口无效，有时还得刷新资源管理器：taskkill /f /im explorer.exe & start explorer.exe

坑三：exe 被杀软清成 0 字节

PATH 修好后，hugo version 报"拒绝访问"，双击弹"此应用无法在你的电脑上运行"。第一反应是版本不兼容，但 echo %PROCESSOR_ARCHITECTURE 是 AMD64，而且第一次明明跑通过。dir 一看真相：

Windows on 言黎的个人博客

Windows 装 Hugo 踩坑记

坑一：winget 装不上，直接下二进制

坑二：PATH 里加的是文件不是目录

坑三：exe 被杀软清成 0 字节