C++ 手写 List 容器：双向链表原理与实现细节

我们按 节点→迭代器→容器类 的依赖顺序来逐步实现 List。

2.1 模块 1：链表节点（list_node）

节点是存储数据的载体，用模板类实现泛型支持，适配任意数据类型。

#pragma once
#include <iostream>
#include <list>
using namespace std;

namespace MyList {
    // 链表节点结构：存储数据与双向指针
    template<class T>
    struct list_node {
        list_node<T>* _prev; // 前驱节点指针
        list_node<T>* _next; // 后继节点指针
        T _data;             // 节点数据

        // 构造函数：默认值初始化，指针置空
        list_node(const T& x = T()) : _prev(nullptr), _next(nullptr), _data(x) {}
    };
}

核心解析：

• 模板参数 T：支持任意数据类型，例如 MyList::list<int> 存储整数，MyList::list<string> 存储字符串。
• 默认构造参数：T() 确保内置类型（如 int）默认初始化为 0，自定义类型自动调用其默认构造函数，兼容性强。
• 指针初始化：_prev 与 _next 初始化为 nullptr，避免野指针风险，后续由容器类统一管理指针链接。

2.2 模块 2：迭代器（list_iterator）

List 的迭代器不是原生指针而是封装 list_node* 的类，通过运算符重载模拟指针行为，同时用'三模板参数'复用普通 /const 迭代器。

namespace MyList {
    // 迭代器类：T-数据类型，Ref-引用类型，Ptr-指针类型
    template<class T, class Ref, class Ptr>
    struct list_iterator {
        using Self = list_iterator<T, Ref, Ptr>; // 简化自身类型名
        using Node = list_node<T>;               // 节点类型别名
        
        Node* _node; // 迭代器指向的节点指针

        // 迭代器构造：接收节点指针初始化
        list_iterator(Node* node) : _node(node) {}

        // 1. 解引用运算符：返回数据引用（普通迭代器可修改，const 不可）
        Ref operator*() { return _node->_data; }

        // 2. 箭头运算符：支持复杂类型成员访问
        Ptr operator->() { return &_node->_data; }

        // 3. 前置++：向后移动（指向后继节点）
        Self& operator++() {
            _node = _node->_next;
            return *this;
        }

        // 4. 后置++：先返回当前，再移动
        Self operator++(int) {
            Self tmp(*this);
            _node = _node->_next;
            return tmp;
        }

        // 5. 前置--：向前移动（指向前驱节点）
        Self& operator--() {
            _node = _node->_prev;
            return *this;
        }

        // 6. 后置--：先返回当前，再移动
        Self operator--(int) {
            Self tmp(*this);
            _node = _node->_prev;
            return tmp;
        }

        // 7. 相等判断：比较节点指针
        bool operator!=(const Self& s) const { return _node != s._node; }
        bool operator==(const Self& s) const { return _node == s._node; }
    };
}

核心解析：

• 三模板参数复用：Ref 为 T& 时是普通迭代器（可修改数据），为 const T& 时是 const 迭代器（只读）；Ptr 同理，避免单独定义 const 迭代器的代码冗余。
• 运算符重载：完全模拟指针行为，遍历（++/--）、访问数据（*/->）的用法与原生指针一致，无需改变使用习惯。
• 无内存管理：迭代器仅作为'导航工具'，不负责节点内存的创建与释放，避免与容器类的内存逻辑耦合。

2.3 模块 3：容器类（list）

容器类整合节点与迭代器，提供构造、插入、删除、遍历等核心接口，底层通过调整指针实现高效的操作。

namespace MyList {
    template<class T>
    class list {
        using Node = list_node<T>; // 节点类型别名
    public:
        // 类型重定义：普通/const 迭代器（复用 list_iterator）
        using iterator = list_iterator<T, T&, T*>;
        using const_iterator = list_iterator<T, const T&, const T*>;

        // -------------------------- 迭代器接口 --------------------------
        iterator begin() { return iterator(_head->_next); }
        iterator end() { return iterator(_head); }
        const_iterator begin() const { return const_iterator(_head->_next); }
        const_iterator end() const { return const_iterator(_head); }

        // -------------------------- 初始化接口 --------------------------
        // 空链表初始化：创建哨兵头节点，形成自环
        void empty_init() {
            _head = new Node;
            _head->_prev = _head;
            _head->_next = _head;
        }

        // 默认构造
        list() { empty_init(); }

        // 初始化列表构造（支持{1,2,3}形式）
        list(initializer_list<T> il) {
            empty_init();
            for (auto& e : il) push_back(e);
        }

        // 范围构造（支持[first, last)区间）
        template<class InputIterator>
        list(InputIterator first, InputIterator last) {
            empty_init();
            while (first != last) {
                push_back(*first);
                ++first;
            }
        }

        // 析构函数：释放所有节点，避免内存泄漏
        ~list() {
            clear();       // 先删除所有数据节点
            delete _head;  // 再删除哨兵头节点
            _head = nullptr; // 置空指针，避免野指针
            _size = 0;
        }

        // -------------------------- 插入删除接口 --------------------------
        // 尾插：复用 insert，简化代码
        void push_back(const T& x) { insert(end(), x); }

        // 头插：复用 insert
        void push_front(const T& x) { insert(begin(), x); }

        // 尾删：复用 erase
        void pop_back() { erase(--end()); }

        // 头删：复用 erase
        void pop_front() { erase(begin()); }

        // 任意位置插入：调整指针实现 O(1) 插入
        void insert(iterator pos, const T& x) {
            Node* cur = pos._node;      // pos 指向的当前节点
            Node* prev = cur->_prev;    // 当前节点的前驱
            Node* newnode = new Node(x);// 新建数据节点

            // 调整指针：prev <-> newnode <-> cur
            newnode->_prev = prev;
            newnode->_next = cur;
            prev->_next = newnode;
            cur->_prev = newnode;

            ++_size; // 有效元素个数递增
        }

        // 任意位置删除：返回下一个有效迭代器，避免失效
        iterator erase(iterator pos) {
            Node* cur = pos._node;   // 待删除节点
            Node* prev = cur->_prev; // 前驱节点
            Node* next = cur->_next; // 后继节点

            // 调整指针：跳过 cur 节点，连接 prev 和 next
            prev->_next = next;
            next->_prev = prev;

            delete cur;              // 释放待删除节点内存
            --_size;                 // 有效元素个数递减

            return iterator(next);   // 返回下一个有效迭代器
        }

        // 清空容器：保留哨兵头节点，便于后续复用
        void clear() {
            iterator it = begin();
            while (it != end()) it = erase(it);
        }

        // -------------------------- 其他接口 --------------------------
        size_t size() const { return _size; }

    private:
        Node* _head;     // 哨兵头节点指针
        size_t _size = 0; // 有效数据节点个数
    };
}

核心解析：

• 空初始化 empty_init()：创建哨兵位头节点统一空链表和非空链表的操作逻辑，避免插入时还需额外判断是否为首节点。
• 接口复用：push_back/push_front 复用 insert，pop_back/pop_front 复用 erase，减少代码冗余。
• 迭代器失效处理：erase 返回下一个有效迭代器，用户可通过 it=erase(it) 更新迭代器，避免访问失效节点，解决 List 迭代器失效的核心痛点。
• 内存管理：析构函数先 clear() 删除所有数据节点，再释放哨兵位头节点，确保无内存泄漏；clear() 进删除数据节点，保留头节点，便于容器后续复用。

三、功能测试：验证 List 正确性

我们用测试用例覆盖构造、遍历、插入、删除等核心场景，验证容器功能。

3.1 测试用例 1：基础构造与遍历

#define _CRT_SECURE_NO_WARNINGS 1
#include "list.h"
using namespace std;

void test_list1() {
    MyList::list<int> lt;
    // 尾插 4 个元素
    lt.push_back(1);
    lt.push_back(2);
    lt.push_back(3);
    lt.push_back(4);

    // 1. 迭代器遍历
    MyList::list<int>::iterator it = lt.begin();
    while (it != lt.end()) {
        cout << *it << " "; // 预期输出：1 2 3 4
        ++it;
    }
    cout << endl;

    // 2. 范围 for 遍历（依赖 begin() 和 end()）
    for (auto e : lt) {
        cout << e << " "; // 预期输出：1 2 3 4
    }
    cout << "\n" << endl;
}

int main() {
    test_list1();
    return 0;
}

结论： 默认构造、尾插及两种遍历方式均正常工作，迭代器 begin()/end() 逻辑正确。

3.2 测试用例 2：头插、头删、尾删

void test_list2() {
    MyList::list<int> lt;
    // 头插 2 个元素，尾插 2 个元素
    lt.push_front(-2);
    lt.push_front(-1);
    lt.push_back(1);
    lt.push_back(2);
    cout << "头插 + 尾插后：";
    for (auto e : lt) cout << e << " "; // 预期输出：-1 -2 1 2
    cout << endl;

    // 尾删 2 次，头删 2 次
    lt.pop_back();
    lt.pop_back();
    lt.pop_front();
    lt.pop_front();
    cout << "删除后 size：" << lt.size() << endl; // 预期输出：0
    cout << endl;
}

int main() {
    // test_list1();
    test_list2();
    return 0;
}

结论： 头插，头删，尾删功能正常，size() 接口能正确反映有效元素个数。

3.3 测试用例 3：const 迭代器与拷贝构造

// 用 const 迭代器遍历的打印函数（验证只读特性）
void Print(const MyList::list<int>& lt) {
    MyList::list<int>::const_iterator it = lt.begin();
    while (it != lt.end()) {
        // *it = 10; // 编译报错：const 迭代器不可修改数据
        cout << *it << " ";
        ++it;
    }
    cout << endl;
}

void test_list3() {
    // 初始化列表构造
    MyList::list<int> lt1 = { 1,2,3,4,5,6 };
    // 拷贝构造
    MyList::list<int>lt2(lt1);
    cout << "lt2（拷贝 lt1）：";
    for (auto e : lt2) cout << e << " "; // 预期输出：1 2 3 4 5 6
    cout << endl;

    // const 迭代器遍历
    const MyList::list<int>& clt = lt1;
    cout << "const 迭代器遍历 lt1：";
    Print(clt); // 预期输出：1 2 3 4 5 6
    cout << endl;
}

int main() {
    // test_list1();
    // test_list2();
    test_list3();
    return 0;
}

结论： 拷贝构造实现深拷贝（修改 lt1 不影响 lt2），const 迭代器仅支持只读访问，符合设计预期。

3.4 测试用例 4：insert、erase 与 clear

void test_list4() {
    MyList::list<int> lt;
    lt.push_back(1);
    lt.push_back(2);
    lt.push_back(3);
    lt.push_back(4);

    // 任意位置插入：在第 2 个元素（2）前插入 100
    auto it = lt.begin();
    ++it;
    lt.insert(it, 100);
    cout << "插入 100 后：";
    for (auto e : lt) cout << e << " "; // 预期输出：1 100 2 3 4
    cout << endl;

    // 任意位置删除：删除 100
    it = lt.begin();
    ++it;
    it = lt.erase(it);
    cout << "删除 100 后：";
    for (auto e : lt) cout << e << " "; // 预期输出：1 2 3 4
    cout << endl;

    // 清空容器
    lt.clear();
    cout << "clear 后 size：" << lt.size() << endl; // 预期输出：0
}

int main() {
    // test_list1();
    // test_list2();
    // test_list3();
    test_list4();
    return 0;
}

结论： 任意位置插入 / 删除功能正常，clear() 能正确清空数据节点，erase 返回的迭代器有效。

结尾

至此，我们完成了从双向循环链表原理到 C++ List 容器的实战落地。从哨兵节点简化边界逻辑，到双向指针支撑迭代器操作，每一步都印证了'底层结构决定容器特性'——正是链表的设计，让 List 在频繁插入删除场景中具备 O(1) 效率。手写 List 的核心价值，在于跳出 STL 黑盒，真正吃透迭代器失效、内存分配等细节，夯实指针操作与容器设计思维。