Kiểm tra và dọn bộ nhớ đệm Hugging Face trên Mac

Xác định vị trí và bảo vệ thành quả

Đường dẫn thường gặp là ~/.cache/huggingface/hub. HF_HUB_CACHE chọn bộ nhớ đệm kho; HF_HOME rộng hơn. Khi chưa đặt HF_HOME, XDG_CACHE_HOME có thể tác động vị trí mặc định; cache_dir có thể chọn đường dẫn khác. Kiểm tra riêng ứng dụng giao diện, terminal và notebook. HF_HOME có thể chứa xác thực: không xóa hết hoặc công khai nội dung.

Checkpoint đã tinh chỉnh, adapter, thay đổi tokenizer, bản chuyển đổi, dữ liệu riêng và cấu hình có thể không tải lại được. Kiểm chứng bản sao lưu vì một số công cụ bỏ qua bộ nhớ đệm có CACHEDIR.TAG. Nếu chưa biết cách khôi phục thì giữ lại; thời điểm truy cập cũ không chứng minh mô hình vô dụng.

Hiển thị ID đầy đủ và cảnh báo

Dừng ứng dụng, tải xuống và tác vụ dùng bộ nhớ đệm. Chạy hf cache ls --no-truncate, tiếp theo hf cache ls --revisions --no-truncate --show-warnings. Bản đã thử mặc định ẩn cảnh báo chi tiết. Luôn dùng cùng --cache-dir với vị trí tùy chỉnh. Tìm hiểu lỗi đọc hoặc cấu trúc, ghi dung lượng dùng và còn trống, không công khai danh sách kho riêng tư.

Kiểm tra phạm vi trước khi xác nhận

hf cache rm cần ID đầy đủ từ CLI. Giữ tiền tố model/ cho kho mô hình; tên thư mục bắt đầu models-- không thay thế được. Với một revision, dùng hash đầy đủ và kiểm tra kho tương ứng. Thêm --dry-run trước. Kết quả là tóm tắt mục tiêu và dung lượng ước tính, không phải danh sách từng tệp. Chọn kho sẽ bao gồm mọi revision được lưu của kho đó.

Sau khi kiểm tra mới bỏ --dry-run, giữ nguyên mục tiêu, đường dẫn và bước xác nhận. Nếu lựa chọn thay đổi hoặc xem trước thất bại, dừng xóa và tìm nguyên nhân. Tệp bị xóa trực tiếp, không vào Thùng rác; khôi phục cần bản sao lưu hoặc quyền tải lại. Snapshot, và ở một số cấu trúc cả các kho, dùng chung blob. Hãy để trình quản lý xử lý tham chiếu, không cộng đơn giản kích thước hiển thị.

Phân biệt prune và các bộ nhớ đệm khác

Ở bản 2.0.0 đã thử, hf cache prune --dry-run xem trước revision detached và tải xuống chưa xong. Không có tham chiếu mang tên vẫn có thể có dự án cố định dùng revision đó. Kiểm tra từng mục và dừng tải xuống đang hoạt động. Lần đầu nên xử lý một mục rõ ràng.

Dữ liệu tạo ra trong HF_DATASETS_CACHE khác với tải xuống Hub. Kiểm tra riêng dữ liệu truyền Xet và đầu ra local_dir, giữ thay đổi cục bộ. Xóa hết HF_HOME không thay thế được việc phân loại này.

Thực sự tải mô hình đã giữ

Đo lại, tải mô hình và revision cần thiết rồi chạy tác vụ nhỏ với kết quả đã biết. Chỉ nhập thư viện Python thành công là chưa đủ. Thử ngoại tuyến bằng cách ngắt mạng thật. Nếu thất bại, dừng dọn dẹp và kiểm tra môi trường, đường dẫn, tệp, quyền truy cập và dung lượng trước khi khôi phục. Liên tục tải lại mô hình cần dùng cho thấy nên đổi mục tiêu hoặc kế hoạch dung lượng.

Khi chuyển sang ổ ngoài, kiểm tra chỗ trống, quyền và hỗ trợ liên kết tượng trưng. Sao chép cả liên kết lẫn đích, cấu hình từng ứng dụng và thử mô hình trước khi bỏ bản gốc. Giữ ổ kết nối khi sử dụng.

Phạm vi đã kiểm chứng

Ngày 2026-09-29 đã dùng huggingface_hub 2.0.0 kiểm tra ngoại tuyến bộ nhớ đệm tổng hợp tạm thời: danh sách, ID đầy đủ, cảnh báo và dry-run. Xem trước không đổi tệp; xóa revision cũ vẫn giữ bản hiện tại cùng dữ liệu chung. Chưa kiểm chứng suy luận thật, bộ nhớ đệm người dùng, dọn blob giữa các kho hay chuyển ổ. Không cam kết dung lượng cố định. Dùng hf cache --help để kiểm tra bản của bạn.

Những điều cần kiểm tra trước khi xóa

Xác nhận vị trí thực tế, mục đích sử dụng và cách khôi phục. Bảng này không phải danh sách xóa tự động và không cam kết giải phóng một lượng dung lượng cố định.

Câu hỏi thường gặp