如何检测当前运行环境是否为Hugo内置服务器？

1. 判断是否运行内置服务器的全局变量 #

Hugo原生提供了专门的变量做该场景判断：

• 新版本（Hugo 0.110.0及以上）直接用全局作用域的 hugo.IsServer，不需要依赖上下文即可调用
• 旧版本可用 .Site.IsServer，判断逻辑完全一致
  执行 hugo server 启动本地开发服务时该变量值为true，执行hugo build生成生产代码时自动变为false。

2. Partial定位提示实现示例 #

你设想的逻辑完全可行，开发环境的代码不会出现在生产构建结果里，保留在代码库中没有安全风险，示例代码如下：

{{ if hugo.IsServer }}
<!-- 仅开发环境渲染的partial定位标识 -->
<div class="dev-partial-tag" 
     data-path="{{ .Name }}"
     style="outline: 2px dashed #f97316; position: relative; margin: 3px 0;">
  <span style="position: absolute; top: -16px; left: 0; background: #f97316; color: #fff; font-size: 11px; padding: 2px 5px; border-radius: 3px; z-index: 99999;">
    partial: {{ .Name }}
  </span>
{{ end }}

<!-- 原有partial的业务代码 -->

{{ if hugo.IsServer }}
</div>
{{ end }}

如果觉得常驻提示影响预览效果，可以把样式调整为hover时才显示的tooltip，使用体验更好。

3. 该方案的潜在问题 #

• 调用partial时如果传入了自定义上下文，可能会出现无法读取.Name的情况，需要你在调用时显式把partial名称作为参数传入，或者用partial.Include传递完整上下文。
• 不要给渲染<head>内标签、<script>、<style>这类非可视化DOM的partial加外层提示div，会破坏HTML结构导致功能异常，这类partial可以改用终端日志输出：{{ if hugo.IsServer }}{{ warnf "已渲染partial：%s" .Name }}{{ end }}。
• 多层嵌套partial的提示块可能出现样式遮挡问题，建议调高提示元素的z-index，或者仅在调试特定模块时开启对应提示。
• 如果开启了开发环境缓存，修改partial后提示可能不会实时刷新，关闭开发缓存即可解决。

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