Python库获取非包内持久缓存目录的规范方法咨询

要获取独立于库包安装路径、可安全写入的持久缓存目录，有两种通用的规范实现：

方案1：使用生态标准库platformdirs（推荐） #

platformdirs是Python生态专门用于跨平台获取系统标准目录的维护库，完全符合各操作系统的目录规范，无需手动处理平台差异。

1. 先安装依赖：
   pip install platformdirs
2. 代码示例：

from platformdirs import user_cache_dir
import os

# 传入你的库名作为命名空间，避免和其他应用的缓存冲突
CACHE_DIR = user_cache_dir(appname="my_library")
# 可选：自动创建目录，避免后续写入报错
os.makedirs(CACHE_DIR, exist_ok=True)

该方案生成的路径完全独立于Python库的安装位置，哪怕库被打包为zip包、安装到系统只读路径、在虚拟环境中运行都不会受影响，缓存内容会持久保留直到用户主动清理。

方案2：标准库原生实现（无第三方依赖） #

如果不想引入额外依赖，也可以手动适配各操作系统的目录规范实现，逻辑如下：

• Linux/Unix：遵循XDG基础目录规范，默认路径为~/.cache/<库名>，支持通过XDG_CACHE_HOME环境变量自定义
• macOS：遵循系统标准目录结构，默认路径为~/Library/Caches/<库名>
• Windows：遵循系统Known Folder规范，默认路径为%LOCALAPPDATA%\<库名>\Cache

代码示例：

import os
import sys

def get_library_cache_dir(app_name: str) -> str:
    if sys.platform.startswith("win"):
        base_dir = os.environ.get("LOCALAPPDATA", os.path.expanduser("~\\AppData\\Local"))
        return os.path.join(base_dir, app_name, "Cache")
    elif sys.platform == "darwin":
        return os.path.expanduser(f"~/Library/Caches/{app_name}")
    else:
        base_dir = os.environ.get("XDG_CACHE_HOME", os.path.expanduser("~/.cache"))
        return os.path.join(base_dir, app_name)

CACHE_DIR = get_library_cache_dir("my_library")
os.makedirs(CACHE_DIR, exist_ok=True)

注意事项 #

• 不要将库包内部路径作为可写缓存目录，除了zip包无法写入的问题外，还可能因为库被安装到系统级只读路径触发权限错误
• 可以在缓存目录下按库版本号创建子目录，避免版本升级后旧缓存格式不兼容的问题
• 临时性文件不要存储在该目录下，临时文件建议使用tempfile模块获取系统临时目录，会被系统自动清理

内容的提问来源于stack exchange，提问作者Роман Коптев