Ollama在Windows上改完模型存储路径后,运行模型时报manifest file missing,通常不是模型文件损坏,而是Ollama按照OLLAMA_MODELS指到的路径找不到匹配的模型索引。问题出在环境变量、目录结构或服务进程三者之一。先不要急着重新拉取模型,按下面顺序确认。
第一步:确认OLLAMA_MODELS真的生效
Windows下模型默认目录是%USERPROFILE%\.ollama\models。修改到其他盘时,需要在系统环境变量中新增或修改OLLAMA_MODELS,指向完整的绝对路径,例如D:\ollama\models。在CMD里执行echo %OLLAMA_MODELS%,如果输出的是新路径,说明变量已设置。如果为空,说明还没生效。
还需要注意,set命令只对当前CMD窗口有效。Ollama一般以后台进程或开机启动方式运行,所以应该通过“系统属性”-“环境变量”设置。修改后必须完全退出Ollama。托盘图标右键退出,并确认任务管理器里没有ollama.exe或ollama_llama_server相关进程,再重新启动。
第二步:检查新路径下目录结构是否完整
Ollama模型目录不是放几个模型文件就行,它包含两个子目录:manifests和blobs。manifests里是JSON索引,记录模型名字和层摘要;blobs里是所有层数据。如果只复制了模型文件或复制不完整,Ollama读不到对应的manifest,就会报缺文件。
迁移时应该复制整个models目录。例如原路径是C:\Users\你的用户名\.ollama\models,新路径是D:\ollama\models,那么复制到新路径后,应该直接看到manifests和blobs两个子目录。执行dir D:\ollama\models确认这类目录存在,且不是空目录。如果你在设置环境变量前先启动过Ollama,Ollama可能已经在新路径下创建了空目录,这时需要先把空目录清理掉,再复制旧内容,或者直接覆盖同名目录。
第三步:迁移或重新拉取模型
如果旧目录还在,优先把原models目录完整复制到新路径。复制前停止Ollama。复制后检查manifests目录下的子目录是否按registry和模型名排列,例如registry.ollama.ai/library/qwen2。如果这层结构没复制,模型列表不会显示。
如果旧目录已经没了,或者复制过去也不完整,就直接用ollama pull 模型名重新拉取。拉取前建议清空新路径下不完整的manifests和blobs,避免残留。重新拉取会生成完整索引,但需要重新下载模型文件,耗时取决于网络和模型大小。
验证与常见误区
重启Ollama后,在CMD运行ollama list。能看到模型列表说明路径识别成功,再执行ollama run 模型名验证加载。如果列表为空,说明路径还没对上或目录结构不对。常见误区包括:只设置环境变量不迁移旧模型;把单个模型文件当成整个目录迁走;忘记重启Ollama进程;路径末尾多写了反斜杠或少了斜杠。处理时建议保留原目录作为备份,等新路径验证通过后再删除。