https://icci.ink/tags/%E5%8D%9A%E5%AE%A2/Recent content in 博客 on ICCIHugozh-cnTue, 10 Mar 2026 00:00:00 +0000https://icci.ink/study/hugo-quick-start/Tue, 10 Mar 2026 00:00:00 +0000https://icci.ink/study/hugo-quick-start/<h2 id="前言">前言<a class="anchor" href="#%e5%89%8d%e8%a8%80">#</a></h2> <p>Hugo 是目前最快的静态网站生成器，用 Go 语言编写，构建速度在<strong>毫秒级别</strong>。这篇指南带你从零搭建一个博客。</p> <h2 id="安装-hugo">安装 Hugo<a class="anchor" href="#%e5%ae%89%e8%a3%85-hugo">#</a></h2> <h3 id="windows">Windows<a class="anchor" href="#windows">#</a></h3> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-powershell" data-lang="powershell"><span style="display:flex;"><span>winget install Hugo.Hugo.Extended</span></span></code></pre></div><h3 id="macos">macOS<a class="anchor" href="#macos">#</a></h3> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>brew install hugo</span></span></code></pre></div><h3 id="linux">Linux<a class="anchor" href="#linux">#</a></h3> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>sudo apt install hugo</span></span></code></pre></div><h2 id="创建站点">创建站点<a class="anchor" href="#%e5%88%9b%e5%bb%ba%e7%ab%99%e7%82%b9">#</a></h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>hugo new site my-blog </span></span><span style="display:flex;"><span>cd my-blog</span></span></code></pre></div><h2 id="添加主题">添加主题<a class="anchor" href="#%e6%b7%bb%e5%8a%a0%e4%b8%bb%e9%a2%98">#</a></h2> <p>以 PaperMod 为例：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>git init </span></span><span style="display:flex;"><span>git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod</span></span></code></pre></div><p>然后在 <code>hugo.toml</code> 中配置：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-toml" data-lang="toml"><span style="display:flex;"><span><span style="color:#a6e22e">theme</span> = <span style="color:#e6db74">&#34;PaperMod&#34;</span></span></span></code></pre></div><h2 id="写文章">写文章<a class="anchor" href="#%e5%86%99%e6%96%87%e7%ab%a0">#</a></h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>hugo new post/my-article/index.md</span></span></code></pre></div><h2 id="本地预览">本地预览<a class="anchor" href="#%e6%9c%ac%e5%9c%b0%e9%a2%84%e8%a7%88">#</a></h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>hugo server -D</span></span></code></pre></div><p>打开 <code>http://localhost:1313</code> 即可看到效果。</p> <h2 id="部署到-github-pages">部署到 GitHub Pages<a class="anchor" href="#%e9%83%a8%e7%bd%b2%e5%88%b0-github-pages">#</a></h2> <ol> <li>在 GitHub 创建仓库 <code>username.github.io</code></li> <li>构建站点：<code>hugo --minify</code></li> <li>将 <code>public/</code> 推送到 GitHub</li> </ol> <h2 id="小结">小结<a class="anchor" href="#%e5%b0%8f%e7%bb%93">#</a></h2> <p>Hugo 的优势在于：</p> <ul> <li>构建速度快</li> <li>单二进制，无依赖</li> <li>模板灵活</li> <li>社区主题丰富</li> </ul> <p>现在就开始你的博客之旅吧！</p>