Hugo安装meghna-hugo主题后运行hugo server报模块不存在错误如何解决

• 基础环境：Parrot OS 系统，通过snap install hugo完成Hugo安装，安装后验证Hugo可正常运行
• 搭建目标：为任职的NGO制作官方网站，选定Hugo官方收录的meghna-hugo作为站点模板
• 终端执行的操作流程：
  1. 初始化站点：执行hugo new site mywebsite创建新站点目录
  2. 进入主题存放目录：执行cd mywebsite/themes
  3. 拉取主题代码：在themes目录下执行git命令克隆meghna-hugo主题仓库
  4. 进入主题示例目录：执行cd meghna-hugo/exampleSite
  5. 文件操作：将exampleSite目录内的全部文件剪切粘贴到自建站点的根目录，覆盖原有站点文件
  6. 启动本地预览：执行hugo server
• 终端返回的错误信息：

Error: module "meghna-hugo" not found; either add it as a Hugo Module or store it in "/home".: module does not exist

• 操作过程参考了两份公开Hugo教程（一份文字教程、一份视频教程）

报错触发原因 #

• 终端当前的工作目录仍停留在mywebsite/themes/meghna-hugo/exampleSite路径，未回到自建站点的根目录，Hugo启动时无法匹配正确的站点结构
• 从exampleSite剪切过来的站点配置文件，默认采用Hugo Module模式加载主题，和本地通过git克隆、挂载在themes目录下的传统主题加载方式不匹配，配置指向的主题资源路径不存在
• 剪切操作可能破坏了themes目录下meghna-hugo主题文件夹的完整性，导致Hugo无法正常识别主题资源

对应修复步骤 #

• 切换终端工作目录至自建站点的根路径mywebsite
• 打开站点根目录下的配置文件（hugo.toml/hugo.yaml/hugo.json），将原有基于Hugo Module的主题引入配置，替换为传统主题引用写法theme = "meghna-hugo"
• 检查themes/meghna-hugo目录的文件完整性，确认主题代码没有被误剪切移走
• 在站点根目录重新执行hugo server，即可正常启动本地预览服务

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