GitHub中.ipynb文件预览失败：Notebook not found错误求助

将VS Code中的.ipynb文件上传至GitHub仓库后，无法查看文件预览，仅显示“Notebook not found”错误。尝试过以下方法均未解决：

• 通过Colab上传文件
• 使用nbviewer查看，返回404错误：

  Not Found Remote HTTP 404: Not Found ({
  "message": "Not Found",
  "documentation_url": "https://docs.github.com/rest"
  })

• 删除仓库重新创建并再次上传

补充说明：能在GitHub中看到文件代码，但预览功能无法正常使用。

附该.ipynb文件内容：

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "hello World\n"
     ]
    }
   ],
   "source": [
    "print('hello World')"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "base",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".ipynb",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.11.5"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}

解决方案 #

• 检查文件命名：别用特殊字符、空格或过长路径给文件命名，GitHub预览服务对这类兼容性差，建议用短文件名，比如test.ipynb。
• 重新导出Notebook：试试用VS Code重新导出一次：打开.ipynb文件，点击右上角的“导出为”→“Notebook (.ipynb)”，覆盖原文件后重新上传。
• 强制刷新页面：GitHub可能缓存了旧状态，在预览页面按Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）强制刷新，跳过缓存加载最新内容。
• 确认仓库权限：如果用nbviewer，仓库必须是公开的；私有仓库要确保自己登录状态正常且有访问权限。
• 直接网页上传：跳过VS Code，直接在GitHub仓库页面点“上传文件”，选择本地.ipynb文件上传，避免本地Git客户端可能的格式转换问题。

内容的提问来源于stack exchange，提问作者Gunnleif