Hugo mod init命令无法生成go.mod文件的问题排查咨询

针对你遇到的在Ubuntu 18.04上用snap安装的Hugo v0.62.2/extended执行hugo mod init后未生成go.mod的问题，我整理了几个排查和解决步骤：

1. 确认hugo mod init的正确用法 #

Hugo的模块初始化命令必须指定模块路径（类似Go模块的模块名），如果直接执行hugo mod init不带参数，Hugo不会生成go.mod文件。你需要执行类似这样的命令：

hugo mod init github.com/your-username/your-hugo-site

这里的模块路径可以是任意合法的域名+项目名格式，不一定需要对应真实存在的远程仓库。

2. 确保当前目录是有效的Hugo项目 #

从你的verbose输出里Using config file:后面是空的可以看出，当前目录没有找到Hugo的配置文件（比如config.toml、config.yaml），Hugo模块功能需要基于一个已初始化的Hugo项目。如果还没有创建项目，先执行：

# 初始化新的Hugo项目
hugo new site my-hugo-project
cd my-hugo-project
# 再执行模块初始化
hugo mod init github.com/your-username/my-hugo-project

3. 排查snap版本Hugo的沙箱限制 #

Snap包的Hugo运行在沙箱环境中，可能存在文件写入权限或环境变量隔离的问题：

• 尝试在用户主目录下创建项目并执行命令，避免系统目录的权限限制；
• 检查当前目录的写入权限，确保你有足够权限创建文件；
• 考虑替换为二进制安装的Hugo，彻底避开snap的沙箱限制：

  # 卸载snap版本的Hugo
  sudo snap remove hugo
  # 下载对应版本的Hugo Extended二进制包（以v0.120.0为例，兼容Ubuntu 18.04）
  wget https://github.com/gohugoio/hugo/releases/download/v0.120.0/hugo_extended_0.120.0_Linux-64bit.tar.gz
  # 解压并安装到系统路径
  tar -xzf hugo_extended_0.120.0_Linux-64bit.tar.gz
  sudo mv hugo /usr/local/bin/
  # 验证安装
  hugo version
  

4. 升级Hugo版本 #

你使用的v0.62.2是2020年的旧版本，Hugo的模块功能在后续版本中做了很多修复和优化。升级到较新的稳定版本（比如v0.120.x系列）可以解决旧版本可能存在的bug。

5. 检查Go环境兼容性 #

虽然你安装了Go 1.13.5，但snap版本的Hugo可能自带了独立的Go环境，与系统Go存在冲突。使用二进制安装的Hugo会自动使用系统的Go环境，避免这类冲突。

按照以上步骤逐一排查，应该能解决go.mod无法生成的问题。

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