Hugo命令找不到是因Go的bin目录未加入PATH，需手动添加$HOME/go/bin（macOS/Linux）或%USERPROFILE%\go\bin（Windows）；go install仅装基础版，完整功能须用GitHub下载的hugo_extended预编译包。
Go 环境装完但 hugo 命令找不到？检查 $PATH 和二进制安装方式
很多人装完 Go，再用 go install github.com/gohugoio/hugo@latest，结果终端敲 hugo 报“command not found”。根本原因不是 Hugo 没装上，而是 Go 的 bin 目录没加进系统 $PATH。
Go 安装后默认把编译出的可执行文件放在 $HOME/go/bin（macOS/Linux）或 %USERPROFILE%\go\bin（Windows）。你得手动把它塞进环境变量：
- macOS/Linux：在
~/.zshrc或~/.bashrc末尾加一行export PATH=$HOME/go/bin:$PATH，然后source ~/.zshrc - Windows：在「系统属性 → 高级 → 环境变量」里，把
%USERPROFILE%\go\bin加到用户级PATH - 验证：运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认路径已存在；再执行hugo version看是否输出版本号
用 go install 装 Hugo 和用预编译二进制包有啥区别？
官方文档推荐下载预编译 hugo_extended 二进制，但很多人图省事直接 go install。这两条路实际效果不同：
-
go install github.com/gohugoio/hugo@latest装的是基础版hugo，不带 Sass/PostCSS 支持，hugo server --enableGitInfo这类功能也受限 - 要完整功能（比如主题里用了
_scss文件），必须装hugo_extended—— 但 Go 官方仓库里没有这个变体，得去 GitHub Releases 页面 下载对应系统的hugo_extended_*.tar.gz包，解压后把hugo二进制扔进$HOME/go/bin或其他$PATH目录 - 注意：Go 1.21+ 对 CGO 的默认行为有变化，某些旧脚本依赖
CGO_ENABLED=1才能编译带扩展的 Hugo，但预编译包完全绕过这层麻烦
Hugo 初始化失败报 failed to load config file？别急着改 config.toml
运行 hugo new site myblog 后进目录一跑 hugo server 就报这个错，大概率是因为 Hugo 默认找 config.yaml、config.json、config.toml，但新建站点只生成了空壳，没自动创建配置文件。
立即学习“go语言免费学习笔记（深入）”；
- 最简解决：手动建一个
config.toml，至少写两行：[baseURL] url = "http://localhost:1313/"
- 别漏掉
baseURL—— 某些主题（如ananke）依赖它生成正确链接，否则首页 CSS 路径 404 - 如果用了
hugo new theme xxx，主题内部的exampleSite/config.*是参考用的，不会自动覆盖根目录配置，得自己复制粘贴 - 验证配置语法：运行
hugo env看当前加载的配置路径，再用hugo -b http://localhost:1313/ -D测试构建是否静默成功
本地预览正常，部署到 GitHub Pages 后样式全丢？查 baseURL 和资源相对路径
这是 Hugo 博客上线最常踩的坑：本地 hugo server 没问题，推到 GitHub Pages 后 CSS、JS 全 404。核心问题在于资源路径生成逻辑和部署目标不匹配。
- GitHub Pages 的项目站点 URL 是
https://<username>.github.io/<repo>/</repo></username>，不是根域名，所以baseURL必须设成带子路径的完整地址，比如https://me.github.io/myblog/ - 同时确保
config.toml里有canonifyURLs = true（让 Hugo 生成绝对路径）和relativeURLs = false（禁用相对路径，避免本地开发和线上行为不一致） - 主题里如果手动写了
href="/css/style.css"这种硬编码路径，会绕过 Hugo 的 URL 构建机制，一律改成href="{{ "/css/style.css" | relURL }}" - 最后一步：用
hugo --baseURL="https://me.github.io/myblog/" -d docs生成静态文件，再检查docs/css/下文件是否存在、docs/index.html中 link 标签 href 是否为https://me.github.io/myblog/css/style.css
Go 环境本身很轻量，真正卡住人的永远是路径、权限、配置优先级这些隐性约定。尤其当多个 config.* 文件共存时，Hugo 会按固定顺序读取并合并，容易误以为改了配置却没生效。
