在 Mac 上解决 LM Studio 无法下载模型的问题(国内镜像替换教程)

如果你在使用 LM Studio 时遇到类似 There was an error fetching results from Hugging FaceModel details error: fetch failed 的报错,大概率是因为国内网络无法稳定连接 Hugging Face 服务器。配置代理可能也无效,但通过替换 LM Studio 内置的 Hugging Face 域名为其国内镜像站 hf-mirror.com,即可快速解决问题。以下是针对 Mac 用户的详细操作教程。


解决方案原理

LM Studio 默认从 huggingface.co 拉取模型,但由于网络限制,国内用户常出现连接失败。通过修改 LM Studio 内部代码,将 huggingface.co 全局替换为国内镜像站 hf-mirror.com,即可绕过网络限制,加速模型下载。


操作步骤

1. 使用 VSCode 打开 LM Studio 资源目录

  • 关闭 LM Studio:确保应用完全退出(可在 Dock 栏右键点击图标选择退出)。

  • 打开指定目录
    通过终端快速定位到目标文件夹,执行以下命令:

    bash 复制代码
    # 使用 VSCode 直接打开目录(需已安装 VSCode)
    code /Applications/LM\ Studio.app/Contents/Resources/app/.webpack
    • 如果终端提示 command not found: code,需先在 VSCode 中安装 Shell Command (通过 Cmd+Shift+P 搜索并选择 Install 'code' command in PATH)。

2. 全局替换 Hugging Face 域名

  • 使用 VSCode 的全局替换功能
    1. 在 VSCode 中按下 Cmd+Shift+H(或通过菜单 Search > Replace in Files)。
    2. 在搜索框输入 huggingface.co,替换框输入 hf-mirror.com
    3. 点击右侧的「替换全部」按钮(需确认替换范围是当前打开的 .webpack 目录)。
    4. 保存所有修改文件(Cmd+S)。

3. 重新启动 LM Studio

  • 重启应用 :重新打开 LM Studio,尝试搜索并下载任意模型(如 Llama-3-8B),此时应能正常加载模型列表并下载。

常见问题

Q1: 替换后应用无法打开怎么办?

  • 恢复备份或重装应用
    如果修改导致 LM Studio 崩溃,建议:
    1. 从官网重新下载并安装 LM Studio。
    2. 重新执行替换步骤,确保仅替换 huggingface.cohf-mirror.com,不要误改其他内容。

Q2: 是否会影响后续更新?

  • 镜像站与官方同步hf-mirror.com 是 Hugging Face 的国内官方镜像,模型和更新与主站实时同步,无需担心数据不一致。

总结

通过替换 LM Studio 的 Hugging Face 域名,国内用户可以无缝下载模型,无需额外配置代理。如果遇到其他问题,欢迎在评论区留言交流!


声明:本教程仅用于技术交流,替换操作需遵守 LM Studio 及 Hugging Face 的相关使用条款。

相关推荐
我爱一条柴ya2 小时前
【AI大模型】深入理解 Transformer 架构:自然语言处理的革命引擎
人工智能·ai·ai作画·ai编程·ai写作
DeepSeek-大模型系统教程20 小时前
深入金融与多模态场景实战:金融文档分块技术与案例汇总
人工智能·ai·语言模型·程序员·大模型·大模型学习·大模型教程
程序员鱼皮1 天前
Cursor 网页版来了,这下拉屎时也能工作了
计算机·ai·程序员·开发·项目·编程经验
我是小哪吒2.01 天前
书籍推荐-《对抗机器学习:攻击面、防御机制与人工智能中的学习理论》
人工智能·深度学习·学习·机器学习·ai·语言模型·大模型
小眼睛FPGA1 天前
【RK3568+PG2L50H开发板实验例程】Linux部分/FPGA dma_memcpy_demo 读写案例
linux·运维·科技·ai·fpga开发·gpu算力
DeepSeek-大模型系统教程1 天前
推荐 7 个本周 yyds 的 GitHub 项目。
人工智能·ai·语言模型·大模型·github·ai大模型·大模型学习
master-dragon2 天前
spring-ai 工作流
人工智能·spring·ai
ZNineSun2 天前
MCP+Cursor入门
ai·cursor·mcp
音视频牛哥2 天前
计算机视觉的新浪潮:扩散模型(Diffusion Models)技术剖析与应用前景
人工智能·计算机视觉·ai·音视频·实时音视频·扩散模型