LM Studio下载的模型默认保存在哪个目录？

Question

在使用LM Studio时，用户常遇到的问题是：通过界面下载的本地大模型默认保存路径不明确，导致后续模型管理、迁移或调用时难以定位文件。许多用户误以为模型会保存在安装目录下，但实际上LM Studio默认将下载的模型存储在操作系统的用户配置目录中。具体路径因系统而异：Windows通常位于 `C:\Users\<用户名>\AppData\Roaming\LMStudio\models`，macOS为 `~/Library/Application Support/LMStudio/models`，Linux则多见于 `~/.config/LMStudio/models`。这一设计虽符合系统规范，但缺乏清晰提示，易造成困惑。如何查看或修改该默认保存路径，成为初学者高频疑问。

Answer 1

1. 问题背景与常见误区

在使用 LM Studio 进行本地大模型部署时，许多用户（尤其是初学者）会遇到一个高频痛点：通过图形界面下载的模型文件无法在预期路径中找到。多数人默认认为模型应保存在软件安装目录下，例如 C:\Program Files\LM Studio 或应用根目录中，但实际上，LM Studio 遵循现代桌面应用的系统规范，将模型存储于操作系统的用户配置目录。

这种设计虽然符合跨平台最佳实践（如 XDG Base Directory 规范、Windows Roaming Data、macOS Application Support），但由于缺乏明确提示或文档说明，导致用户在进行模型迁移、备份、外部调用（如 Ollama、Python 脚本加载）时出现定位困难。

2. 各平台默认模型存储路径详解

以下是主流操作系统中 LM Studio 默认的模型存储路径，适用于当前稳定版本（v0.2.x 及以上）：

操作系统	默认路径	说明
Windows	C:\Users\%USERNAME%\AppData\Roaming\LMStudio\models	AppData 为隐藏目录，需手动启用显示
macOS	~/Library/Application Support/LMStudio/models	Library 目录默认隐藏，可通过 Finder 快捷键访问
Linux	~/.config/LMStudio/models	遵循 XDG_CONFIG_HOME 规范，兼容大多数发行版

3. 如何查看当前模型存储路径

用户可通过以下方式确认实际模型存放位置：

1. 打开 LM Studio 应用程序；
2. 进入左侧导航栏的 “Local Server” 页面；
3. 启动任意已下载模型，观察右上角显示的模型加载路径；
4. 该路径通常以 file:// 开头，可直接复制并转换为本地文件系统路径；
5. 也可在终端执行命令验证：

# macOS/Linux 示例
ls ~/.config/LMStudio/models   # Linux
ls ~/Library/Application\ Support/LMStudio/models  # macOS

# Windows PowerShell 示例
Get-ChildItem $env:APPDATA\LMStudio\models

4. 修改默认模型保存路径的方法

目前 LM Studio 官方尚未提供 GUI 界面直接修改模型存储路径的功能，但可通过环境变量或符号链接实现变通方案：

• 方法一：使用符号链接（Symbolic Link）

适用于希望保留默认行为但将数据重定向至更大磁盘空间的情况。

# Linux/macOS 示例：将默认路径链接到自定义目录
mkdir /mnt/large_disk/lm_models
mv ~/.config/LMStudio/models ~/.config/LMStudio/models.bak
ln -s /mnt/large_disk/lm_models ~/.config/LMStudio/models

• 方法二：通过启动参数或环境变量覆盖（实验性）

部分用户反馈设置 LM_STUDIO_DATA_PATH 环境变量可影响数据目录，但此功能未被官方文档确认，存在版本兼容风险。

5. 模型管理的最佳实践建议

针对 IT 从业者及高级用户，推荐以下模型管理策略：

1. 建立统一的模型仓库目录，如 /opt/ai/models 或 D:\AI\Models；
2. 使用脚本定期同步或备份关键模型文件；
3. 结合 model-card.json 文件记录元信息（名称、版本、用途）；
4. 在团队协作环境中，使用 Git LFS 或 MinIO 对模型进行版本化管理；
5. 利用 Docker 容器封装 LM Studio + 模型路径映射，提升可移植性；
6. 监控磁盘使用情况，避免因大模型累积导致系统分区满载；
7. 配置软链接时注意权限一致性，防止应用无权读取；
8. 在 CI/CD 流程中集成模型路径校验步骤；
9. 对敏感模型启用加密存储或访问控制；
10. 记录所有路径变更操作，便于审计与故障排查。

6. 故障排查流程图

graph TD
    A[无法找到下载的模型] --> B{检查是否在安装目录?}
    B -- 是 --> C[提示误解: 模型不存于此处]
    B -- 否 --> D[查找系统配置目录]
    D --> E[Windows: AppData/Roaming/LMStudio/models]
    D --> F[macOS: ~/Library/Application Support/LMStudio/models]
    D --> G[Linux: ~/.config/LMStudio/models]
    E --> H[是否存在模型文件?]
    F --> H
    G --> H
    H -- 否 --> I[检查网络下载是否完成]
    H -- 是 --> J[获取完整路径用于外部调用]
    I --> K[重新下载或清理缓存]