★ FEATURED ARTICLE 发布时间2026年10月9日版本v0.40.2 Latest项目github.com/ollama/ollamaollama v0.40.2 已正式发布。本次版本更新的重点并不在于新增大量功能而是围绕模型兼容性、运行性能、版本升级后的存储管理以及模型列表展示体验进行了针对性优化。其中最值得关注的变化是此前通过旧版本 Ollama 下载的模型在首次运行时会自动于后台升级以获得更好的 llama.cpp 运行性能与兼容性与此同时为了让用户能够安全降级Ollama 会临时保留原始模型副本作为备份。这样一来模型升级过程更加稳妥但也意味着磁盘上可能会暂时多占用一部分空间。除此之外v0.40.2 还解决了ollama list中升级模型可能出现重复条目的问题并且进一步隐藏用于降级保护的内部标签让模型列表回归更简洁、直观的状态。一、核心更新概览v0.40.2 的主要变化可以概括为以下几个方向旧版本下载的模型会在首次运行时于后台完成升级升级后的模型可以获得更好的 llama.cpp 性能与兼容性为确保用户可以安全降级升级前的原始模型会暂时保留为备份后续版本将自动清理这些升级产生的备份模型当前版本已经提供手动清理备份模型的方式ollama list不再显示升级模型产生的重复条目用于降级保护的内部模型标签不再出现在模型列表中ollama launch claude将使用模型完整的上下文长度README 社区集成列表新增oxi从表面看这次发布的提交数量不多但其中模型升级、模型列表去重、降级保护标签隐藏等改动直接影响本地模型管理与日常使用体验。二、旧模型首次运行时将自动后台升级v0.40.2 最关键的更新是针对早期版本下载模型的自动升级机制。发布说明明确指出通过较早版本 Ollama 下载的模型在用户首次运行这些模型时会在后台自动完成升级。该升级的目标是让模型在 llama.cpp 环境中运行时获得更好的性能和兼容性。换句话说用户不需要手动重新下载模型也不需要自行判断某个模型是否需要迁移或转换。当旧模型第一次被调用运行时Ollama 会自动处理对应的升级工作。这一机制带来的直接意义是用户已有的模型不需要立即手动重新拉取模型在实际使用时才触发升级减少不必要的即时操作升级过程在后台进行降低用户对模型格式变化的感知模型升级后更适配 llama.cpp 的运行需求使用旧版本下载模型的用户可以逐步过渡到新的兼容状态这里需要注意的是升级触发点并不是安装 v0.40.2 的瞬间而是在模型第一次运行时。也就是说某个模型即使已经存在于本地只要尚未被运行就可能还没有完成相应的后台升级。这种方式可以避免一次性对所有本地模型进行集中处理也让升级过程与实际模型使用行为保持一致。三、为什么升级后还要保留原始模型副本自动升级虽然能够带来性能和兼容性改善但模型升级并不是简单地覆盖原始文件。为了让降级操作保持安全Ollama 在升级模型时会保留原始模型副本作为备份。也就是说升级后的模型和原始模型可能会在一段时间内同时保存在本地磁盘中。这样设计的原因很明确如果用户之后将 Ollama 降级到早于 0.40 的版本旧版本仍然需要原来的模型副本才能继续正常使用。因此v0.40.2 中的备份并非无意义的重复数据而是一项降级保护措施。这一机制可以理解为场景模型状态使用旧版本下载模型本地保留原始模型升级到 v0.40.2 后首次运行模型后台生成或使用升级后的模型状态升级完成后原始模型副本继续保留作为降级备份继续使用 v0.40 及以上版本可以选择清理旧备份以释放空间降级到早于 0.40 的版本需要保留的原始模型副本来保证可用性从存储角度看这意味着模型升级后的短期磁盘占用可能会增加。对于本地模型数量较多、模型体积较大的用户而言这一点尤其值得注意。例如如果本地存放了多个大型模型并且这些模型都在升级后被运行过那么升级后的版本与原始备份可能会共同存在。虽然 v0.40.2 并未要求用户立即清理备份但用户应当了解这些旧副本会在磁盘中暂时占据空间。四、未来版本会自动清理备份当前可手动清理发布说明中提到未来的 Ollama 版本将自动移除这些升级过程中保留的备份模型。这意味着当前 v0.40.2 的备份保留行为属于过渡阶段的兼容性设计。后续版本将承担自动清理职责减少用户手动维护本地存储的成本。不过在未来版本实现自动清理前如果用户已经确认自己不会降级到早于 0.40 的 Ollama 版本也可以立即手动删除这些备份模型。官方提供了以下清理命令。curl-slocalhost:11434/api/tags|jq-r.models[].name|whileread-rm;docurl-slocalhost:11434/api/show-d{\model\:\$m\}|jq-r\select(any(.manifests[]?; .runner llamacpp)) | .manifests[] | select(.runner ggml) | .digestdone|sort-u|xargs-n1ollamarm该命令执行的目的是删除由升级过程保留下来的备份模型。需要特别强调的是这条命令只会删除备份不会删除当前正在使用的升级后模型。发布说明对此有明确说明此操作仅删除备份模型不会影响当前升级后的模型如果之后需要降级到早于 0.40 的版本则必须重新拉取这些模型因此是否执行清理命令取决于用户是否仍有回退到旧版本 Ollama 的需求。五、手动清理命令的执行逻辑虽然命令看起来较长但它的处理流程非常清晰。首先它会请求本地 Ollama 服务的模型标签接口curl-slocalhost:11434/api/tags该接口返回本地模型列表。随后命令通过jq从返回结果中提取全部模型名称jq-r.models[].name得到模型名后命令会依次读取每一个模型并调用模型详情接口curl-slocalhost:11434/api/show-d{\model\:\$m\}这个接口会返回模型的相关清单信息。接下来命令会筛选出与llamacpp运行器相关的模型清单select(any(.manifests[]?;.runnerllamacpp))然后继续从清单中筛选运行器为ggml的条目并提取对应的摘要值.manifests[]|select(.runnerggml)|.digest在获得摘要值后命令会执行去重sort-u最后对每一个唯一摘要执行模型删除操作xargs-n1ollamarm因此这段命令的整体逻辑可以概括为获取本地所有模型名称逐个查询模型详细信息找出与 llama.cpp 相关的模型清单筛选其中运行器为ggml的备份对象提取并去重模型摘要使用ollama rm删除这些备份执行该命令的前提是系统中已经安装jq。发布说明也明确注明手动删除备份需要jq工具。六、清理备份前必须了解的限制手动清理备份模型能够释放磁盘空间但它并不适合所有用户。如果用户已经确定会持续使用 v0.40 或更高版本且不计划降级到旧版那么删除备份是合理的存储优化操作。但如果用户仍然存在以下情况就应当谨慎清理需要测试早于 0.40 的 Ollama 版本可能因兼容性问题回退到旧版本当前环境中存在版本切换需求希望保留旧模型副本作为降级保障原因在于一旦删除了备份模型之后再降级到早于 0.40 的版本时本地将不再保留对应的原始模型文件。此时若要继续使用这些模型就需要重新拉取。因此清理操作本质上是在“节省当前磁盘空间”和“保留未来降级便利性”之间进行选择。可以简单理解为不降级可清理备份可能降级建议保留备份已清理后又要降级需要重新拉取模型七、ollama list不再显示升级模型的重复条目除了模型升级与备份管理v0.40.2 还优化了模型列表展示。此前在模型升级后的相关场景中ollama list可能会显示重复条目。对于用户而言这会造成一定困扰同一个模型看起来像是出现了多个版本用户难以直接判断哪一个才是当前本地首选、实际会被使用的模型。v0.40.2 对此进行了调整。更新后ollama list不再为升级模型显示重复条目。对于包含多个子运行器清单的模型列表系统不再把每个子运行器都作为独立行展示而是只展示本地首选的子项。这一变化使模型列表从“一个模型可能出现多行”变为“一个模型展示其当前首选的本地子项”。从实现描述来看原有逻辑是一个模型清单列表会为每个子运行器生成一行记录而更新后的逻辑变为一个模型清单列表只展示被选中的子项展示的记录以被选择子项的摘要作为标识该记录会保留父级模型的修改时间这项调整直接提升了ollama list的可读性。用户在终端中查看模型列表时不再需要面对同一个模型对应多个运行器条目的情况也无需自行分辨其中哪个是当前本地优先使用的版本。八、模型列表展示逻辑发生了什么变化从测试调整可以看出模型列表行为的变化非常明确。此前测试的目标是验证模型清单列表中的子项是否会作为独立行全部出现在列表中。更新后测试目标已经变为验证模型清单列表是否只展示首选子项。测试场景中包含两个子项一个使用gguf格式的子项一个使用safetensors格式的子项此前的预期是该模型在列表中会出现两行分别对应两个子项。而 v0.40.2 的新预期是该模型在列表中只出现一行。同时这唯一展示出来的行必须满足以下条件它的摘要值必须等于当前被选择子项的摘要值它代表的是模型当前首选的本地子项不再要求所有运行器对应的子项都出现在列表中这意味着ollama list现在更像是一个面向用户的“当前可用模型视图”而不是展示所有内部清单子项的完整技术视图。对于普通使用者而言这种变化更符合直觉用户看到的是当前模型实际优先使用的版本而不是内部多个候选运行器的全部记录。九、降级保护标签将被隐藏v0.40.2 还专门处理了降级保护标签在模型列表中的展示问题。在升级过程中Ollama 会生成与降级保护相关的内部模型标记。此前如果这些标签直接出现在ollama list中用户可能会看到一些不属于日常模型管理范畴的额外条目。新版本增加了对应的过滤逻辑。当模型名称匹配 llama.cpp 运行器与对应摘要组成的降级保护标签时该条目会被直接跳过不再显示在模型列表中。这项变化的意义在于内部降级保护机制继续存在模型备份仍然可用于旧版本回退用户不必在ollama list中看到这些内部标签模型列表更加聚焦于用户主动管理和使用的模型升级、备份、兼容性处理等内部流程不会干扰日常查看体验结合“只显示首选子项”的调整v0.40.2 对模型列表的整体方向非常清晰减少内部实现细节对用户界面的干扰。用户更关心的是“我当前有哪些模型可以使用”而不是“该模型内部存在多少运行器清单、多少升级备份或多少降级保护标签”。十、ollama launch claude使用模型完整上下文长度本次更新中还有一项与模型上下文相关的变化。ollama launch claude现在会使用模型的完整上下文长度。上下文长度决定了模型单次能够处理和保留多少输入内容。对于需要处理较长对话、较长文本、较大代码上下文或连续任务的场景上下文长度尤为重要。此次调整意味着在通过ollama launch claude启动时模型将按其完整上下文能力运行而不是使用较小或受限的上下文范围。从发布内容来看这项改动的描述非常直接启动 Claude 时采用模型的完整上下文长度。对于使用该启动方式的用户而言这意味着模型能够按自身支持的完整上下文配置执行任务。十一、README 社区集成新增oxi除核心模型管理与列表逻辑更新外v0.40.2 还更新了 README 中的社区集成内容。新增的集成项目为oxi。该项目被描述为一个原生 Rust 桌面编码智能体包含以下能力编辑器Git 面板终端README 中原有的社区集成列表涵盖多个与 Ollama 协作使用的工具而本次新增的oxi进一步丰富了桌面端编码智能体相关的集成选择。其定位并不是独立替代 Ollama而是作为可与 Ollama 生态关联的社区集成之一面向需要编辑器、代码版本管理面板和终端能力的桌面编码工作流。十二、发布涉及的变更范围本次发布的比较视图显示共包含3 次提交3 个文件发生变化3 位贡献者参与涉及的文件包括README.mdserver/model_list.goserver/routes_list_test.go从文件分布可以看出v0.40.2 的更新重点集中在三个方面文件对应变化README.md新增oxi社区集成说明server/model_list.go调整模型列表逻辑隐藏降级保护标签仅展示首选子项server/routes_list_test.go更新测试预期从展示全部子项改为展示首选子项其中README 的改动较小主要是增加一条社区集成信息。服务端模型列表逻辑则是本次功能行为变化的核心。它既负责过滤掉降级保护标签也负责避免将同一个模型清单中的多个子运行器都展示给用户。测试文件同步调整证明新的预期已经从“展示全部子项”切换为“仅展示当前首选子项”。十三、提交时间线此次变更的提交时间线包括2026年10月2日README 增加oxi社区集成2026年10月8日相关 README 变更合并2026年10月8日服务端更新模型列表逻辑隐藏重复项与降级保护项2026年10月9日v0.40.2 发布从时间顺序看社区集成更新先完成随后模型列表逻辑调整完成最终形成 v0.40.2 发布内容。虽然提交数量较少但服务端模型列表调整与模型升级后的备份管理说明共同构成了本次版本的主要价值。十四、v0.40.2 对不同用户的影响对于不同使用方式的用户这次更新带来的影响并不完全相同。对于已有大量本地模型的用户最值得关注的是首次运行模型时可能发生后台升级以及升级后原始副本会被保留。这类用户应关注磁盘空间变化尤其是本地保存了多个大体积模型时。若确认不会降级到旧版本可以根据官方命令清理备份。对于经常查看模型列表的用户ollama list将变得更干净。升级模型产生的重复条目不再显示内部降级保护标签也会被隐藏。用户看到的是当前本地首选的模型子项而不是全部内部清单记录。对于有版本回退需求的用户建议保留升级前的备份模型。因为一旦手动清理备份而后续又需要使用早于 0.40 的版本就必须重新拉取这些模型。对于使用ollama launch claude的用户模型将使用完整上下文长度运行。这是本次版本中与启动行为直接相关的一项调整。对于关注 Ollama 工具生态的用户README 社区集成中新增了oxi为原生 Rust 桌面编码智能体场景提供了新的集成信息。十五、升级后应该怎么做对于已经升级到 v0.40.2 的用户可以根据自身情况进行以下处理。第一步正常运行已有模型旧版本下载的模型会在首次运行时于后台升级因此通常不需要额外手动操作。第二步观察本地磁盘空间如果本地模型很多或者使用的是大参数量模型应关注升级后备份副本带来的额外空间占用。第三步决定是否保留降级能力如果未来可能使用早于 0.40 的版本应保留备份。如果确认不会降级可以使用官方提供的命令删除备份模型。第四步查看模型列表执行ollama list后列表中将不再显示升级模型的重复记录也不会显示用于降级保护的内部标签。第五步关注后续版本未来版本将自动移除这些备份模型。因此当前手动清理更多是面向希望立即释放磁盘空间的用户。十六、总结ollama v0.40.2 是一次围绕模型升级兼容性和本地模型管理体验展开的更新。其核心价值可以归纳为四点旧模型在首次运行时会自动后台升级以提升 llama.cpp 的性能和兼容性升级前模型会作为备份暂时保留以确保降级过程安全用户可通过官方命令手动删除备份但删除后降级到早于 0.40 的版本需要重新拉取模型ollama list将不再显示升级模型的重复条目和降级保护标签并且仅展示模型列表中的首选子项同时ollama launch claude已改为使用模型完整上下文长度README 社区集成列表也新增了oxi。整体来看v0.40.2 并不是一次追求大量新功能的版本而是一次专注于升级平滑性、模型存储管理、列表展示简洁性与运行兼容性的实用更新。对于本地模型用户来说这次升级最大的变化是模型会更平稳地迁移到新的运行状态而用户看到的模型列表则会更加清晰。
阅读完成 · 觉得有帮助？
