游戏客户端架构 / 系统课时
建立资源缓存
建立资源缓存
资源缓存要解决的是“同一路径被重复加载”的问题。本课将实现一个最小可用的缓存:第一次请求时读取资源,后续请求直接复用同一实例,并在资源已释放后允许再次加载。
学习目标
- 理解资源缓存的键、值和命中流程
- 使用
std::unordered_map与智能指针复用资源实例 - 识别路径不统一、永久持有和并发访问等边界问题
缓存解决什么问题
纹理、音频和字体通常来自磁盘。若每个游戏对象都独立读取同一文件,不仅会重复执行 I/O 和解码,还会在内存中产生多份内容相同的资源。
资源缓存把“资源标识”映射到“已加载实例”。调用方只负责提出请求,缓存负责判断当前应当复用旧实例,还是创建新实例。
缓存键与命中流程
缓存键必须稳定。同一个文件若同时使用 assets/hero.png、./assets/hero.png 和包含 .. 的路径表示,就可能被误判为三个资源。实际项目应先规范化路径,必要时还要统一大小写和资源包前缀。

一次请求通常经过三个步骤:先规范化资源键,再查询缓存,最后根据弱引用是否仍然有效决定复用或回源。缓存本身不应让无人使用的资源永久驻留,因此示例使用 std::weak_ptr 保存实例。
实现最小资源缓存
下面的完整示例模拟纹理加载。两次请求使用不同写法的等价路径,规范化后会命中同一个缓存项。
#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;
}预期输出:
读取文件: assets/hero.png
命中缓存: assets/hero.png
同一实例: truefirst 与 second 指向同一对象,因此纹理只读取一次。待两个强引用都释放后,缓存中的弱引用会失效;下次请求相同路径时会重新创建资源。
缓存边界与常见错误
缓存键除路径外,有时还要包含加载参数。例如同一图片可能以“生成 mipmap”和“不生成 mipmap”两种方式加载,此时只用文件名作为键会错误复用不兼容的实例。
示例默认单线程。真实引擎若允许加载线程和渲染线程同时访问缓存,应使用互斥锁保护查询与写入,或把资源请求集中到专用管理线程,避免两个线程同时判定未命中并重复创建。
缓存也不能替代错误处理。文件不存在、格式损坏或显存上传失败时,应返回明确错误或占位资源,而不是把无效对象永久写入缓存。
本课总结
- 资源缓存通过稳定键复用已加载实例,减少重复 I/O、解码和内存占用
- 使用弱引用保存缓存项,可以避免缓存本身阻止资源释放
- 路径规范化、加载参数和并发访问共同决定缓存是否可靠
下一课预告
下一课将继续处理资源何时创建、由谁持有以及何时释放,并用引用计数建立可预测的资源生命周期。