游戏客户端架构 / 系统课时

建立资源缓存

建立资源缓存

资源缓存要解决的是“同一路径被重复加载”的问题。本课将实现一个最小可用的缓存:第一次请求时读取资源,后续请求直接复用同一实例,并在资源已释放后允许再次加载。

学习目标

  • 理解资源缓存的键、值和命中流程
  • 使用 std::unordered_map 与智能指针复用资源实例
  • 识别路径不统一、永久持有和并发访问等边界问题

缓存解决什么问题

纹理、音频和字体通常来自磁盘。若每个游戏对象都独立读取同一文件,不仅会重复执行 I/O 和解码,还会在内存中产生多份内容相同的资源。

资源缓存把“资源标识”映射到“已加载实例”。调用方只负责提出请求,缓存负责判断当前应当复用旧实例,还是创建新实例。

缓存键与命中流程

缓存键必须稳定。同一个文件若同时使用 assets/hero.png、./assets/hero.png 和包含 .. 的路径表示,就可能被误判为三个资源。实际项目应先规范化路径,必要时还要统一大小写和资源包前缀。

资源缓存命中与回源流程

一次请求通常经过三个步骤:先规范化资源键,再查询缓存,最后根据弱引用是否仍然有效决定复用或回源。缓存本身不应让无人使用的资源永久驻留,因此示例使用 std::weak_ptr 保存实例。

实现最小资源缓存

下面的完整示例模拟纹理加载。两次请求使用不同写法的等价路径,规范化后会命中同一个缓存项。

cpp
#include <filesystem>
#include <iostream>
#include <memory>
#include <string>
#include <unordered_map>
#include <utility>

class Texture {
public:
    explicit Texture(std::string path) : path_(std::move(path)) {
        std::cout << "读取文件: " << path_ << '\n';
    }

private:
    std::string path_;
};

class TextureCache {
public:
    std::shared_ptr<Texture> load(const std::string& rawPath) {
        const std::string key = normalizeKey(rawPath);

        // weak_ptr 不延长资源寿命,lock 成功表示资源仍被外部使用
        if (auto found = cache_[key].lock()) {
            std::cout << "命中缓存: " << key << '\n';
            return found;
        }

        auto texture = std::make_shared<Texture>(key);
        cache_[key] = texture;
        return texture;
    }

private:
    static std::string normalizeKey(const std::string& path) {
        return std::filesystem::path(path).lexically_normal().generic_string();
    }

    std::unordered_map<std::string, std::weak_ptr<Texture>> cache_;
};

int main() {
    TextureCache cache;
    auto first = cache.load("assets/../assets/hero.png");
    auto second = cache.load("assets/hero.png");

    std::cout << std::boolalpha
              << "同一实例: " << (first.get() == second.get()) << '\n';
    return 0;
}

预期输出:

text
读取文件: assets/hero.png
命中缓存: assets/hero.png
同一实例: true

first 与 second 指向同一对象,因此纹理只读取一次。待两个强引用都释放后,缓存中的弱引用会失效;下次请求相同路径时会重新创建资源。

缓存边界与常见错误

缓存键除路径外,有时还要包含加载参数。例如同一图片可能以“生成 mipmap”和“不生成 mipmap”两种方式加载,此时只用文件名作为键会错误复用不兼容的实例。

示例默认单线程。真实引擎若允许加载线程和渲染线程同时访问缓存,应使用互斥锁保护查询与写入,或把资源请求集中到专用管理线程,避免两个线程同时判定未命中并重复创建。

缓存也不能替代错误处理。文件不存在、格式损坏或显存上传失败时,应返回明确错误或占位资源,而不是把无效对象永久写入缓存。

本课总结

  • 资源缓存通过稳定键复用已加载实例,减少重复 I/O、解码和内存占用
  • 使用弱引用保存缓存项,可以避免缓存本身阻止资源释放
  • 路径规范化、加载参数和并发访问共同决定缓存是否可靠

下一课预告

下一课将继续处理资源何时创建、由谁持有以及何时释放,并用引用计数建立可预测的资源生命周期。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建立资源缓存

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通