C++ 深度解析：从 .size() 到 capacity，彻底搞懂容器的“大小”与“容量”

摘要：

• 基础篇：std::string 中 .length() 和 .size() 到底有什么区别？该用哪个？
• 进阶篇：为什么 vector 没有 .length()？
• 核心篇：什么是 capacity？它和 size 有什么关系？为什么理解它能让你的代码性能提升 10 倍？

本文将通过代码演示和内存图解，带你一次性打通 C++ 容器管理的任督二脉。

---

📸 第一部分：字符串的“长度”之谜

先看一段经典的 C++ 代码，很多初学者在这里就会产生第一个疑问：

#include <iostream>
#include <string>

int main() {
    std::string str = "Hello World";

    // 两种方法结果完全一样
    std::cout << "Size: " << str.size() << std::endl;
    std::cout << "Length: " << str.length() << std::endl;

    return 0;
}

输出结果：

Size: 11
Length: 11

❓ 灵魂拷问：既然一样，为什么要设计两个函数？

真相是：它们完全等价。
在 std::string 的源码实现中，length() 仅仅是 size() 的一个内联别名：

// libstdc++ 源码示意
size_type length() const noexcept { return this->size(); }

• 历史原因：C 风格字符串习惯用 strlen (length)，而 STL 容器统一规范为 size。为了兼容老程序员的习惯，STL 保留了 length()。
• 最佳实践：
  • 统一使用 .size()。
  • 理由：C++ STL 的所有容器（vector, list, map, array）只有 .size()，没有 .length()。统一使用 .size() 可以保持代码风格的一致性，减少思维切换成本。

✅ 结论：忘掉 .length() 吧，.size() 才是 C++ 的亲儿子。

---

🧠 第二部分：揭开 capacity (容量) 的神秘面纱

如果说 size 是“面子”，那 capacity 就是“里子”。这是区分 C++ 新手和高手的关键分水岭。

1. 核心定义

概念	英文	含义	生动比喻
大小	size()	容器中当前实际存储的元素个数。	书架上实际放了多少本书。
容量	capacity()	容器在不重新分配内存的情况下，最大能容纳的元素个数。	书架总共能放多少本书的空间。

数学关系：
$$\text{capacity}\ge \text{size}$$

2. 为什么 capacity 通常大于 size？

std::vector (以及 std::string) 为了极致的性能，采用了倍增扩容策略。

当你不断调用 push_back 时：

1. 如果 size < capacity：直接放入新元素，O(1) 时间，极快。
2. 如果 size == capacity：触发扩容 (Reallocation)。
   • 申请一块更大的新内存（通常是原来的 2 倍，具体取决于编译器实现）。
   • 将旧数据拷贝/移动到新内存。
   • 释放旧内存。
   • 放入新元素。

代价：扩容涉及内存分配和数据拷贝，开销巨大。
收益：避免了每次插入都重新分配内存，使得 push_back 的均摊时间复杂度仍为 O(1)。

3. 代码实证：观察扩容过程

让我们看看 vector 是如何“长大”的：

#include <iostream>
#include <vector>

int main() {
    std::vector<int> v;
    
    std::cout << "Initial -> Size: " << v.size() 
              << ", Capacity: " << v.capacity() << std::endl;

    for (int i = 1; i <= 5; ++i) {
        v.push_back(i);
        std::cout << "Insert " << i << " -> Size: " << v.size() 
                  << ", Capacity: " << v.capacity() << std::endl;
    }
    return 0;
}

典型输出（GCC/Clang 常见行为）：

Initial -> Size: 0, Capacity: 0
Insert 1 -> Size: 1, Capacity: 1    <-- 首次分配
Insert 2 -> Size: 2, Capacity: 2    <-- 扩容 (1->2)
Insert 3 -> Size: 3, Capacity: 4    <-- 扩容 (2->4)
Insert 4 -> Size: 4, Capacity: 4    <-- 无需扩容
Insert 5 -> Size: 5, Capacity: 8    <-- 扩容 (4->8)

👉 注意：当插入第 3 个和第 5 个元素时，capacity 发生了跳跃，而 size 只是线性增长。这就是“预留空间”的威力。

---

🛠️ 第三部分：如何主动控制内存？（性能优化实战）

理解了 size 和 capacity 的关系，你就可以从“被动态扩容”转变为“主动内存规划”。

1. reserve(n)：预分配内存 (性能神器 ⭐)

如果你知道大概要存多少数据，务必在循环前调用 reserve()。

❌ 低效写法（可能触发多次扩容）：

std::vector<int> v;
// 假设要插入 10000 次
for(int i = 0; i < 10000; ++i) {
    v.push_back(i); 
    // 内部可能经历：1->2->4->8...->8192->16384 等多次内存重分配和拷贝
}

✅ 高效写法（零扩容）：

std::vector<int> v;
v.reserve(10000); // 直接分配能存 10000 个整数的内存

for(int i = 0; i < 10000; ++i) {
    v.push_back(i); 
    // 此时 size 增加，但 capacity 足够，不会触发任何内存重分配！
}

效果：在大数据量场景下，reserve 可以将运行时间缩短数倍甚至十倍。

2. shrink_to_fit()：收缩内存 (节省内存)

如果你从一个很大的 vector 中删除了大量元素，capacity 并不会自动减小（为了保留空间以备后续插入）。如果确定不再需要那么多空间，可以请求收缩。

std::vector<int> v(10000); // 容量很大
// ... 处理数据 ...
v.resize(10); // size 变小了，但 capacity 可能还是 10000

v.shrink_to_fit(); // 请求将 capacity 缩减至接近 size
// 注意：这是一个非绑定请求，标准库实现可以选择忽略，但主流编译器都会执行。

---

📊 总结速查表

操作/概念	适用容器	作用	性能影响	建议
.size()	所有 STL 容器	获取当前元素个数	O(1)	永远首选，替代 .length()
.length()	仅 string	同 .size()	O(1)	仅在维护旧代码时使用
.capacity()	vector, string	获取当前内存容量	O(1)	用于调试和性能分析
.reserve(n)	vector, string	预分配容量	避免多次 realloc	已知大小时必用
.shrink_to_fit()	vector, string	释放多余容量	可能触发 realloc	内存敏感场景使用

---

💡 终极建议

1. 数个数：永远用 .size()。忘掉 .length()，除非你在维护古老的 C++ 代码。
2. 写循环：如果不确定数据量，直接用 push_back，依赖自动扩容（均摊 O(1) 依然很快）。
3. 搞性能：如果数据量大且已知范围（如读取文件行数、网络包大小），先用 .reserve() 预分配。这是最简单的性能优化手段。
4. 省内存：如果容器用完不再需要大量空间，调用 .shrink_to_fit() 或使用 swap 技巧 (vector<T>().swap(v)) 释放内存。

🌟 金句：
“.size() 告诉你现在有多少货，.capacity() 告诉你仓库有多大。优秀的程序员不仅会数货，更懂得如何规划仓库。”

---

互动一下：
你以前知道 vector 有 capacity 这个概念吗？你在项目中用过 reserve 来优化性能吗？欢迎在评论区分享你的经验或踩坑故事！