最稳妥方式是下载GitHub上的.ipynb文件到本地,进入该目录运行jupyter notebook后在浏览器中点击打开;也可用!curl -O下载单个文件或!git clone拉取整个仓库,但Jupyter不支持直接通过URL打开远程文件。

直接运行 GitHub 上的 .ipynb 文件在本地 Jupyter 中是不可能的——Jupyter 本身不支持通过 URL 打开远程 notebook,必须先下载或克隆到本地文件系统。
怎么把 GitHub 的 .ipynb 文件弄到本地再打开
这是最稳妥、兼容性最好的方式,适用于所有系统(Windows/macOS/Linux)和所有 Jupyter 版本。
- 打开 GitHub 页面,找到目标
.ipynb文件(比如example.ipynb) - 点击右上角 Raw 按钮,进入纯文本页面
- 浏览器按
Ctrl+S(Windows)或Cmd+S(macOS)保存为example.ipynb,注意确认后缀是.ipynb(不是.txt) - 确保该文件所在目录已启动 Jupyter:终端进入该目录,运行
jupyter notebook或jupyter lab - 在浏览器界面中点击文件名即可打开并运行
用 !git clone 在 notebook 里拉代码行不行
可以拉整个仓库,但不能直接“运行 GitHub 链接”——!git clone 是 shell 命令,只负责下载,后续仍需手动打开文件。
- 在 notebook 的一个单元格里输入:
!git clone https://github.com/username/repo.git - 执行后会生成
repo/目录,里面可能含多个.ipynb文件 - 刷新 Jupyter 文件浏览器(或重启 kernel),就能看到新目录和其中的 notebook
- ⚠️ 注意:如果仓库含大量非 Python 资源(如大 FASTQ 文件、模型权重),
clone会很慢,且占用本地磁盘 - 更轻量的选择是只下载单个文件:
!curl -O https://raw.githubusercontent.com/username/repo/main/notebook.ipynb
为什么不能直接用 URL 在 Jupyter 里打开 .ipynb
Jupyter 的 Web 界面设计上只读取本地文件系统路径,不解析 HTTP URL。尝试粘贴 GitHub 链接到地址栏或新建 notebook 里写 open("https://...") 都会失败。
- 典型报错:
FileNotFoundError: [Errno 2] No such file or directory: 'https://github.com/...' -
nbviewer(如https://nbviewer.jupyter.org/github/...)只是渲染器,不执行代码,也不能交互 - 某些第三方扩展(如
jupyterlab-github)能浏览 GitHub 内容,但依然不能“运行”,只能预览或下载
小白最省事的替代方案:用 Colab
如果你只是想快速跑通代码、验证逻辑、不想装环境,Google Colab 是唯一真正支持“点链接就运行”的方案。
- 复制 GitHub 上
.ipynb文件的 raw 链接(格式类似https://raw.githubusercontent.com/xxx/main/file.ipynb) - 访问
https://colab.research.google.com→ 左上角 File → Open notebook → 选 Github 标签页 → 粘贴链接 - Colab 会自动加载并允许你修改、运行、保存(关联 Google Drive)
- ⚠️ 注意:Colab 默认环境不含项目依赖,首次运行常需补装包,比如在第一个单元格加:
!pip install pandas biopython
真正卡住人的地方往往不是“怎么打开”,而是打开后缺依赖、路径不对、或 notebook 依赖其他本地脚本——这些都得靠你手动检查 import 和 os.chdir() 行为,而不是指望 Jupyter 自动解决。


















