ChatGLM2-6B本地模型加载失败排查指南：从报错到解决

1. 遇到ChatGLM2-6B本地加载报错怎么办？

最近在本地部署ChatGLM2-6B模型时，不少开发者都遇到了类似的报错信息："OSError: /chatglm2-6b does not appear to have a file named config.json"。这个错误看似简单，但背后可能隐藏着多种原因。作为一个踩过这个坑的老手，我来分享下完整的排查思路和解决方案。

这个错误的核心是模型加载时找不到配置文件config.json。可能的原因包括：模型文件下载不完整、文件路径设置错误、下载源不稳定等。我遇到过最棘手的情况是，明明文件夹里有config.json文件，但程序就是找不到，后来发现是文件权限问题。

2. 方法一：完整下载模型文件

2.1 从官方渠道获取模型

最稳妥的方式是从清华大学云盘下载完整模型：

1. 访问清华大学云盘：https://cloud.tsinghua.edu.cn/d/674208019e314311ab5c/
2. 下载完整的模型压缩包
3. 解压到本地目录，比如/chatglm2-6b

2.2 使用Git LFS克隆仓库

如果要从Hugging Face直接克隆，建议使用以下命令：

bash复制GIT_LFS_SKIP_SMUDGE=1 git clone https://huggingface.co/THUDM/chatglm2-6b

这个命令会先克隆仓库结构，但不会立即下载大文件。克隆完成后，可以手动下载缺失的文件。

2.3 使用镜像地址加速下载

国内用户可能会遇到下载速度慢的问题，可以尝试使用镜像地址：

bash复制GIT_LFS_SKIP_SMUDGE=1 git clone https://hf-mirror.com/THUDM/chatglm2-6b

我实测下来，镜像地址的下载速度要稳定得多，特别是在晚上高峰期。

3. 方法二：使用ModelScope下载

3.1 安装ModelScope

对于国内开发者，我更推荐使用阿里的ModelScope：

bash复制pip install modelscope

3.2 通过ModelScope下载模型

下载代码非常简单：

python复制fr