LM Studio 这几年几乎是本地大模型玩家的默认选择,界面干净、内置推理引擎,还能直接拉 Hugging Face 上的模型。但有一个问题几乎每个人都会撞上:模型默认下载位置在 C 盘。C 盘本来就放系统、装软件、缓存各种临时文件,再塞几个动辄 4GB、8GB 的 GGUF 模型,很快就红了。这篇文章我想把 LM Studio 修改 models 下载位置的几种方案完整拆开讲一遍,包括默认路径到底在哪里、怎么改最省心、改了之后会遇到哪些坑以及如何排查。适合刚接触本地大模型的入门用户,也适合已经装了不少模型、C 盘告急想迁移的老玩家。
1. 为什么默认的 models 路径是个"必踩的坑"
1.1 先搞清楚 LM Studio 到底把模型放在哪
很多人打开 LM Studio,点下载模型之后从来没想过文件去了哪里。它不会弹窗告诉你要装到哪个目录,而是直接写进用户目录下的隐藏缓存文件夹。不同系统的默认位置不完全一样,用我的实际经验整理一下:
- Windows:
C:\Users\<你的用户名>\.cache\lm-studio\models - Linux:
~/.cache/lm-studio/models或~/.lmstudio/models(取决于发行版和安装方式) - macOS:
~/.cache/lm-studio/models
不太熟悉结构的人容易忽略一个问题:.cache是隐藏目录,在资源管理器里默认看不到。所以很多人明明下载了几百 GB 模型,却迟迟没发现 C 盘容量悄悄被吞掉,还以为是 Windows 更新残留。我第一次帮朋友排查电脑卡顿时,用WinDirStat扫了一遍才看到C:\Users\xxx\.cache\lm-studio占了 130 多 GB,这就是模型下载位置的第一个坑——不是找不到路径,是根本没有意识到它在系统盘里。
1.2 模型体积比你想的夸张得多
我建议在动手之前先算一下你的模型能占多大空间。本地大模型常用的 GGUF 量化格式,体积随参数规模和量化等级变化:
- 7B 模型,Q4 量化,通常在 4GB 到 5GB 之间,例如 Qwen2.5-7B-Instruct 的 Q4_K_M 约 4.4GB。
- 13B 模型,Q4 量化,通常 7GB 到 8GB。
- 32B/70B 级别的模型,Q4 量化通常要 20GB 到 40GB,如果下的是 F16 或 FP32 原版,单个文件轻轻松松超过 100GB。
哪怕你只下了三四个 7B 模型,C 盘也会多出 20GB 占用。如果你玩的是 70B 模型、多会话并行,C 盘剩余空间会直线下降。最关键的是,C 盘不仅是存储盘,也是系统和软件运行的临时交换分区,剩余空间不足会导致 LM Studio 加载模型时内存映射缓慢,甚至出现加载失败、页面文件不足的报错。所以这个修改不是单纯为了"让 C 盘好看一点",而是直接影响推理稳定性和性能。
1.3 游戏盘、系统盘、模型盘应该分开的思维
我个人的习惯是:本地模型文件应该当作"数据集"来管理,而不是当作"应用数据"来对待。应用的配置和缓存可以留在用户目录,但动辄几十 GB 的权重文件必须单独盘存放。
原因有三个:第一,模型文件随机读取频繁,放在机械硬盘上和放在 NVMe 固态硬盘上的加载速度差异非常明显;第二,C 盘一旦出现分区空间紧张,Windows 的临时文件机制和系统更新会进一步压缩剩余空间,最终导致磁盘 IO 性能下降;第三,换了系统、重装了应用,只要模型目录独立,原目录和模型文件可以完全保留,重新指定一下路径就能直接接着用。
从这个角度出发,修改 LM Studio 的模型下载位置,本质上是一次"存储责任划分"式的规范化管理。
2. 动手前先理清楚:三种改路径的路子,各有适用场景
2.1 应用内设置:最直观但要看版本
新版 LM Studio(0.3 版本之后)在设置里提供了模型文件夹的配置入口,菜单路径大致是 Settings -> Model Folders,或者直接在左侧模型详情页下方找 "Manage Model Locations"。在新版本上,你可以直接添加一个或多个模型目录,LM Studio 会扫描这些目录并把里面的模型自动列到库里。
具体到 UI 操作,一般是这样:
- 打开 LM Studio,进入左侧模型面板。
- 找到类似 "My Models" 或 "Local Models" 的入口,里面有一个"文件夹图标"或"管理目录"按钮。
- 点击后可以新增一个目录,选择磁盘空间充足的路径,例如
D:\LMS\Models。 - 保存后 LM Studio 会重建模型索引,把新目录里的 GGUF 文件全部扫描出来。
这个方法的好处是没有命令行操作,路径是应用直接识别的,不需要做什么映射或链接。缺点是如果你的版本较老,可能根本没有这个入口。还有一点,应用内设置仅修改"索引扫描目录",它并不会自动把默认下载位置改掉。在某些版本中,你从 Hugging Face 页面点击 Download 时,仍有可能下载到旧目录。所以应用内设置更适合"添加本地已有模型",而不是"重定向下载位置"。
2.2 符号链接:最通用最彻底的"搬家"方案
如果你希望所有下载行为都指向新位置,而不只是手动扫描本地模型,我推荐的做法是:把默认的 models 目录整个"搬家",然后用符号链接在原位置创建一个指向新位置的入口。这样 LM Studio 从软件层面看,路径还是C:\Users\<用户名>\.cache\lm-studio\models,但真实的文件已经落在新盘。所有下载、加载、保存都会自动落到新目录,不需要在设置里做任何额外操作。
这里先解释一下符号链接的概念。你可以把它理解成"桌面快捷方式",但比快捷方式更底层。LM Studio 访问原路径时,操作系统会自动把请求转发到真实路径。对软件来说,原路径始终"存在且可用",所以 LM Studio 不会报错,也不需要改配置。这个方案的好处在于:
- 对应用完全透明,不会出现"旧路径找不到模型"的问题。
- 下载、扫描、缓存全部走新路径,彻底解决 C 盘占用。
- 一条命令即可完成,不需要改任何配置文件。
不过在操作上有一个前提:你必须先把原目录里的文件完整移动到新位置,再创建符号链接。如果原目录还存在大量文件,直接建链接会失败或者导致目录结构混乱。
2.3 环境变量:冷门但有效,适合有洁癖的人
还有一种方法是通过 LM Studio 识别的环境变量来修改缓存根目录,不过这个方法在不同系统上的可靠度并不统一。LM Studio 基于 Electron 和底层推理运行时构建,它在很多版本中会遵循XDG_CACHE_HOME或HF_HOME这类环境变量。如果你设置了XDG_CACHE_HOME=D:\LMStudioCache,LM Studio 的默认路径会变成D:\LMStudioCache\lm-studio\models。但要注意,这个变量会影响很多其他应用的缓存目录,副作用比较大,不太建议新手使用。我把它列出来只是为了让你知道有这条路,实际项目中我更推荐符号链接方案。
3. 实操:两种最可靠的修改 models 下载位置的方法
3.1 方案一:新版本设置界面直接修改模型目录
在动手之前,先打开 LM Studio 右上角的设置齿轮,确认版本号。如果你的版本是 0.3.x 或更高,大概率有模型目录管理入口。我最常用的操作流程是:
- 在左侧导航栏点击 "Models" 进入模型管理页。
- 找到标题栏下方或左上角的 "Manage" 按钮,也可能是三个点的下拉菜单,里面有 "Model Folder" 选项。
- 点击后弹出一个目录选择器,此时新增一个目录,例如
D:\LMS\Models。 - 保存并关闭,LM Studio 会自动扫描这个目录下的模型。
这里要提醒一个容易误解的地方:新增目录后,LM Studio 界面会出现两个模型来源列表,一个是默认缓存区(原来的),一个是新增的D:\LMS\Models。你下载模型时的默认保存位置仍然可能是旧目录,需要额外注意。
如果你希望把所有模型统一到新目录,那么我建议直接在设置里把旧目录"移出"列表,只保留新目录。在 UI 上可能是 "Remove" 或 "Unlink" 操作。移除后,LM Studio 将只扫描新目录。但是,如果你旧目录里还有未搬走的模型,它们会暂时从模型列表里消失。先把旧文件复制到新目录,再移除旧目录,模型就完整地"搬"过去了。
这个做法有一个小坑:如果你在 LM Studio 运行的时候直接把旧目录移除,正在运行的模型不受影响,因为权重已经加载到内存里了,但下次重新加载时如果找不到文件就会报错。所以建议先关闭已经加载的模型,再做目录变更。
3.2 方案二:用符号链接彻底搬家(Windows 和 Linux 都讲)
方案二是我自己最常用的做法,也是所有版本通用的硬核方案。在 Windows 上,用管理员权限打开 CMD 或 PowerShell,按下面的步骤操作:
- 关闭 LM Studio。
- 打开资源管理器,进入
C:\Users\<你的用户名>\.cache\lm-studio,确认models目录是否存在。如果不存在,先运行一次 LM Studio 并下载一个最小模型(或者直接手动创建这个目录)。 - 在目标盘创建一个新目录,比如
D:\LMS\Models。 - 把原来
models目录下的所有内容移动到D:\LMS\Models。注意是移动,不是复制一份留原处,否则 C 盘占用不会减少。 - 回到
C:\Users\<你的用户名>\.cache\lm-studio,把已经空的models目录删除。 - 以管理员身份打开 CMD,执行:
mklink /D "C:\Users\<你的用户名>\.cache\lm-studio\models" "D:\LMS\Models"mklink /D表示创建目录符号链接。执行成功后,你在原路径看到一个带快捷方式小箭头的models文件夹,但它已经指向 D 盘。
Linux 和 macOS 上的操作类似,只是命令换成ln -s:
# 先移动 mv ~/.cache/lm-studio/models /mnt/data/LMSModels # 再创建符号链接 ln -s /mnt/data/LMSModels ~/.cache/lm-studio/models需要注意一个细节:原models目录不能有残留文件,否则mv之后目录不空,ln -s虽然能创建链接,但原路径下会有一层多余的目录包裹,或者导致目录树混乱,LM Studio 扫描不到模型。
符号链接建立后,启动 LM Studio,模型列表会自动加载新目录下的所有模型。你可以直接点击下载新模型,LM Studio 实际写入的位置是D:\LMS\Models,但应用本身完全感知不到路径变化。这个方法对任何版本的 LM Studio 都有效,而且 C 盘占用不会因为后续下载继续增长。
3.3 移动已有模型时的文件传输技巧
很多人在第 4 步"移动文件"阶段会遇到性能问题。如果 C 盘原 models 目录已经积攒了几百 GB 模型,直接拖动文件会非常慢,甚至复制到一半中断。我建议使用以下方法:
- 如果你有 Windows 文件历史记录或备份工具,先把原目录压缩成镜像再解压到新盘,效率反而不高,不建议。
- 最稳的做法是用
robocopy(Windows 自带)进行断点续传式复制。在 CMD 里执行:
robocopy "C:\Users\<用户名>\.cache\lm-studio\models" "D:\LMS\Models" /E /MOVE/E表示复制所有子目录和文件(含空目录),/MOVE表示复制完成后删除源目录文件。
robocopy的好处是支持多线程复制,而且出错会重试,不会像资源管理器那样动不动就中断。复制上百 GB 大文件时,实测速度比手动拖拽快不少。Linux 用户则推荐用rsync:
rsync -av --progress ~/.cache/lm-studio/models/ /mnt/data/LMSModels/确认无误后,再手动清理原目录。
4. 改完位置之后,我踩过的那些坑
4.1 模型列表刷不出来,不是路径错了,是索引没刷新
符号链接方案改完路径后,最常遇到的问题就是 LM Studio 的模型列表里看不到任何模型,或者新下载的模型一直显示"下载中"却始终不出现。相当一部分人以为是符号链接没生效,其实问题出在 LM Studio 的索引缓存上。
LM Studio 会维护一个模型索引文件,记录模型路径、文件列表和元数据。如果你移动了模型文件或新建了目录,LM Studio 需要重新扫描。我的经验是:先完全退出 LM Studio(检查系统托盘是否还有残留进程),再重新打开,一般就能触发重新扫描。如果还不行,可以在设置里找到 "Clear Cache" 或手动删除模型索引缓存文件(通常位于.cache/lm-studio下的 metadata 或 index 目录)。删除后重启应用,它会强制重建索引。
4.2 原目录非空导致符号链接失败
Windows 上执行mklink /D时最常见的报错是"无法创建文件或目录,因为该目录已存在"。这就是因为我前面强调的——原models目录还没删干净。有些隐藏文件、系统属性文件你肉眼看不到,用资源管理器删除可能删不掉,这时候可以在 CMD 里执行:
rmdir /S /Q "C:\Users\<用户名>\.cache\lm-studio\models"注意/S /Q会递归删除目录且不确认,一定要确认里面没有想要的模型了再执行。我建议在移动完成后,先用磁盘占用工具(比如WinDirStat)核对 C 盘占用是否下降,再执行删除。
4.3 外接盘、网络盘、映射盘带来的隐藏风险
我遇到过一个比较隐蔽的问题:把 models 目录放在 D 盘,但 D 盘是一块外接移动硬盘,或者是一个 BitLocker 加密盘、网络映射盘。这些东西在系统启动时不一定自动挂载,如果 LM Studio 先启动,而 D 盘还没准备好,应用就会把符号链接指向一个"空的、不存在的"路径,模型列表自然全是空的。
更麻烦的是,某些加密盘在解锁前路径不可用,LM Studio 启动时会静默失败,不会弹任何错误提示。我建议:第一优先把模型放在电脑内置的第二块固态硬盘上;第二,如果必须用外接盘,至少确保它设置成开机自动挂载;第三,盘没准备好的情况下,先手动打开资源管理器确认盘符可见,再启动 LM Studio。
4.4 权限不足导致模型下载失败
修改目录后还有一个常见问题:模型下载到一半失败,或者 LM Studio 直接提示"Permission denied"。这个问题的根源是目标盘根目录没有写入权限,或者新目录的 ACL 权限配置有问题。在 Windows 上,如果你是在D:\根目录直接建了一个Models文件夹,默认情况下当前用户对该文件夹有完全控制权,一般不会出问题。但如果你的 D 盘是 NAS 映射、高性能扩展盘、或者是从旧系统迁移过来的盘,目录权限可能是继承来的,当前用户没有写入权限。
解决方法是右键目录,选择属性,进入安全选项卡,把当前用户或 Users 组添加到"完全控制"列表。Linux 系统则直接chown -R $USER:$USER /mnt/data/LMSModels即可。
4.5 多个模型目录并存:重复扫描与去重
有些人看完这篇文章后用了应用内设置而不是符号链接,于是新旧两个目录都存在,LM Studio 把两边都加进了索引。此时模型列表会重复显示——同样的模型、同样的文件名,出现两次。这不致命,但当你点击加载其中一个时,LM Studio 会尝试加载两份,造成显存占用翻倍、加载时间变长,甚至因为 mmap 冲突崩溃。
我的建议是:同一时间只保留一个目录来源。要么用应用内设置只留新目录,要么用符号链接彻底覆盖原目录。不要搞"双目录并行"。如果真的有几个模型必须分两个不同的盘存,那可以在 LM Studio 里为每个目录建一个"命名空间"来区分,但日常使用越简单越好。
5. 常见问题速查与排查实录
5.1 一份能直接"抄作业"的问题排查表
我把这一年里遇到过的高频问题列成了一张表,方便你在改完路径后快速定位问题:
| 问题现象 | 可能原因 | 排查与解决 |
|---|---|---|
| 模型列表空白 | LM Studio 索引未刷新 | 完全退出应用后重启,或删除索引缓存强制重建 |
| 下载模型后 C 盘空间还在涨 | 下载路径没有真正重定向 | 检查符号链接是否创建成功,确认mklink目标路径 |
| 原路径文件删不掉 | 目录非空或文件被占用 | 用rmdir /S /Q强制删除,但先确认没有模型残留 |
| 模型加载报"File not found" | 盘符未就绪或链接指向失效路径 | 检查目标盘是否挂载,重新创建符号链接 |
| 复制大文件中断 | 资源管理器复制不稳 | 用robocopy或rsync更换传输方式 |
| LM Studio 设置里找不到目录管理 | 版本过旧 | 升级到最新版本,或直接使用符号链接方案 |
| 模型重复显示 | 新旧目录并存 | 移除其中一个目录来源,保持单目录结构 |
5.2 从"改目录"到"管理模型库"的一点经验
改完下载位置之后,我强烈建议你再做一件事:给模型文件夹建立一个规范的子目录结构。LM Studio 默认的目录结构是models/<组织名>/<模型名>/<量化版本文件>,例如models/Qwen/Qwen2.5-7B-Instruct/Qwen2.5-7B-Instruct-Q4_K_M.gguf。如果你自己手动导入模型,一定要保持这个层级,否则 LM Studio 可能无法正确解析模型名称和归属。
另外,每次下载新模型之前,先看一眼目标盘的剩余空间。有些模型页面写的是"约 4.1GB",但下载时会同时下载多个分片文件(split parts),加起来可能翻倍。空间不足时下载会失败,失败后 LM Studio 会遗留一个残缺的.part文件,下次再下同款模型时偶尔会冲突。遇到这种问题,直接到新目录下把所有.part结尾的文件删掉,再重新下载一次就好了。
6. 最后一次实践的小结与建议
这套操作我前后在不同电脑上做了很多次,踩坑踩多了之后,现在的基本流程已经固定成:先升级 LM Studio 到最新版,看有没有应用内目录管理;如果有,直接添加新目录并移除旧目录,把模型搬到新位置;如果没有,就用符号链接一步到位。两种方式最终都能解决 C 盘告急的问题,但符号链接更彻底,因为它连"下载行为"本身也重定向了。
我个人在实际操作中最喜欢的一点是,符号链接方案能让我随时切换模型存储盘而不影响任何配置。比如我要把模型从 D 盘迁到 E 盘,只需要把真实目录从 D 盘移走,删掉旧链接,重新执行mklink或ln -s指向新路径,LM Studio 完全不用动,打开就能用,所有历史记录和模型列表都不受影响。这也算是一个"一次配置、随时搬家"的思路。
最后还有一个值得琢磨的小技巧:如果你同时使用多个 AI 工具,例如 Workbuddy、Text Generation WebUI,它们的模型目录也经常和 LM Studio 类似。既然你已经学会了符号链接,完全可以把这些工具的模型路径统一映射到同一个模型库目录,多个工具共享一份权重文件,磁盘占用至少省一半,管理起来也更清爽。第一次配置时多花十分钟,后面能省掉很多重复下载的麻烦。