https://geowisdom.com.cn/tags/%E8%BF%9B%E5%BA%A6%E6%9D%A1/Recent content in 进度条 on 知星悟地Hugo -- 0.153.2en-usSun, 10 May 2026 08:00:00 +0800https://geowisdom.com.cn/posts/resource/utilsxx/readme_progress_bar/Sun, 10 May 2026 08:00:00 +0800https://geowisdom.com.cn/posts/resource/utilsxx/readme_progress_bar/<h2 id="引言">引言</h2> <p>命令行程序在处理耗时任务时，一个直观的进度条能极大提升用户体验。然而 C++ 标准库并未提供终端进度条组件，开发者要么引入重型第三方库，要么自己手写 ANSI 转义码控制光标。</p> <p><code>progress_bar</code> 是 <a href="https://github.com/geophyxx/utilsxx">utilsxx</a> 库中的轻量级终端进度条组件，它<strong>零依赖、跨平台、开箱即用</strong>，同时提供了 <code>indicators</code> 第三方库的集成示例，满足不同场景需求。本文将带你一文看懂如何使用它，以及有哪些实用技巧。</p> <hr> <h2 id="一快速上手三行代码显示进度条">一、快速上手：三行代码显示进度条</h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-cpp" data-lang="cpp"><span style="display:flex;"><span><span style="color:#75715e">#include</span> <span style="color:#75715e">&#34;progress_bar.hpp&#34;</span><span style="color:#75715e"> </span></span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#66d9ef">int</span> <span style="color:#a6e22e">main</span>() { </span></span><span style="display:flex;"><span> utilsxx<span style="color:#f92672">::</span>progress_bar bar(<span style="color:#e6db74">&#34;Processing&#34;</span>, <span style="color:#ae81ff">101</span>); </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#66d9ef">for</span> (<span style="color:#66d9ef">int</span> i <span style="color:#f92672">=</span> <span style="color:#ae81ff">0</span>; i <span style="color:#f92672">&lt;</span> <span style="color:#ae81ff">101</span>; <span style="color:#f92672">++</span>i) { </span></span><span style="display:flex;"><span> bar.tick(); <span style="color:#75715e">// 每步调用一次 </span></span></span><span style="display:flex;"><span> <span style="color:#75715e">// 你的耗时操作... </span></span></span><span style="display:flex;"><span> } </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span> <span style="color:#66d9ef">return</span> <span style="color:#ae81ff">0</span>; </span></span><span style="display:flex;"><span>} </span></span></code></pre></div><p>终端输出效果：</p> <pre tabindex="0"><code>Processing |████████████████████████████████████████░░░░░░░░░░| 75.0% </code></pre><hr> <h2 id="二核心设计">二、核心设计</h2> <h3 id="21-两种显示模式">2.1 两种显示模式</h3> <table> <thead> <tr> <th>模式</th> <th>枚举值</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td><strong>完整模式</strong></td> <td><code>Full</code></td> <td>进度条 + 百分比数字（默认）</td> </tr> <tr> <td><strong>数字模式</strong></td> <td><code>NumberOnly</code></td> <td>仅显示百分比数字，无图形条</td> </tr> </tbody> </table> <h3 id="22-颜色系统">2.2 颜色系统</h3> <p>支持已完成部分和未完成部分分别设置颜色：</p> <table> <thead> <tr> <th>颜色</th> <th>枚举值</th> <th>ANSI 效果</th> </tr> </thead> <tbody> <tr> <td>白色</td> <td><code>White</code></td> <td>默认粗体</td> </tr> <tr> <td>绿色</td> <td><code>Green</code></td> <td>粗体绿色</td> </tr> <tr> <td>红色</td> <td><code>Red</code></td> <td>粗体红色</td> </tr> <tr> <td>蓝色</td> <td><code>Blue</code></td> <td>粗体蓝色</td> </tr> <tr> <td>黄色</td> <td><code>Yellow</code></td> <td>粗体黄色</td> </tr> </tbody> </table> <h3 id="23-智能宽度适配">2.3 智能宽度适配</h3> <p>进度条长度<strong>自动根据终端宽度计算</strong>，无需手动调整：</p>