问题：如何设置ModelScope模型下载路径的环境变量？

Question

在使用 ModelScope 进行模型下载和加载时，合理设置模型下载路径对于管理模型文件、节省磁盘空间或指定特定存储位置至关重要。默认情况下，ModelScope 会将模型下载到系统默认缓存目录中，但在实际应用中，我们往往需要自定义模型下载路径。 本文将详细介绍如何通过设置环境变量 `MODELSCOPE_CACHE` 来指定 ModelScope 的模型下载路径。你将学习到在不同操作系统（如 Linux、macOS 和 Windows）下如何正确配置该环境变量，并了解其作用范围和优先级。此外，我们还将演示如何在代码中动态指定模型路径，以及如何验证路径设置是否生效。 通过本文，你将掌握灵活控制 ModelScope 模型存储位置的方法，从而更好地适配项目部署和资源管理需求。

Answer 1

灵活配置 ModelScope 模型下载路径的完整指南

一、理解 ModelScope 默认模型缓存机制

ModelScope 是一个集模型下载、加载、推理于一体的平台化工具，广泛应用于 AI 模型的部署与管理。默认情况下，ModelScope 会将模型缓存到系统默认目录中，具体如下：

• Linux: ~/.cache/modelscope
• macOS: ~/Library/Caches/modelscope
• Windows: %APPDATA%\Roaming\modelscope\cache

这种默认行为在开发阶段较为方便，但在生产部署、资源隔离或磁盘空间受限的场景下，往往需要自定义模型的存储路径。

二、通过环境变量 MODELSCOPE_CACHE 自定义模型路径

ModelScope 提供了环境变量 MODELSCOPE_CACHE，用于指定模型缓存的根目录。设置该变量后，所有模型的下载和加载都将基于该路径进行。

2.1 Linux/macOS 系统设置方法

在 Linux 或 macOS 系统中，可以通过命令行或修改 shell 配置文件来设置环境变量：

export MODELSCOPE_CACHE=/path/to/your/model/cache

若希望永久生效，可将上述命令添加到 ~/.bashrc、~/.zshrc 或系统级配置文件中。

2.2 Windows 系统设置方法

在 Windows 中，可以通过命令行或系统环境变量设置：

set MODELSCOPE_CACHE=C:\path\to\your\model\cache

若需永久生效，可使用如下命令：

setx MODELSCOPE_CACHE "C:\path\to\your\model\cache"

2.3 环境变量的作用范围与优先级

环境变量 MODELSCOPE_CACHE 的作用范围为当前用户当前会话。若在代码中显式指定了模型路径（见下文），则该路径优先级高于环境变量设定。

三、在代码中动态指定模型路径

除了使用环境变量外，还可以在代码中直接指定模型的下载和加载路径，适用于需要动态控制模型存储位置的场景。

from modelscope.pipelines import pipeline
from modelscope.utils.constant import Tasks

model_path = '/your/custom/model/path'
asr_pipeline = pipeline(task=Tasks.auto_speech_recognition, model=model_path)

若模型尚未下载，该路径将作为下载目标目录；若模型已存在，则直接从该路径加载。

四、验证路径设置是否生效

为确保路径设置正确，可以通过以下方式验证：

1. 查看模型下载日志，确认目标路径是否被正确使用。
2. 检查目标路径下是否生成了对应的模型文件夹。
3. 使用 Python 代码打印模型加载路径：

print(asr_pipeline.model.model_dir)

五、路径管理的高级技巧与最佳实践

在实际部署中，合理管理模型路径对于资源调度、版本控制和多用户协作至关重要。以下是一些推荐做法：

• 为不同项目或模型分配独立路径，避免文件冲突。
• 定期清理缓存目录，释放磁盘空间。
• 在 Docker 或 Kubernetes 环境中，将模型路径挂载为 volume，实现持久化存储。
• 结合 ModelScope 的模型版本机制，使用路径命名策略（如 /models/v1.0.0）进行版本隔离。

六、总结与延伸

通过本文的介绍，我们了解了如何通过设置环境变量 MODELSCOPE_CACHE 来控制 ModelScope 的模型缓存路径，并掌握了在代码中动态指定模型路径的方法。合理配置模型路径不仅可以优化磁盘使用效率，还能提升模型管理的灵活性和可维护性。