模型 / 数据集
TingsongYu/PyTorch-Tutorial-2nd avatar
TingsongYu/PyTorch-Tutorial-2nd

PyTorch 实用教程第二版:从张量到 TensorRT 的开源路线图

《Pytorch实用教程》(第二版)无论是零基础入门,还是CV、NLP、LLM项目应用,或是进阶工程化部署落地,在这里都有。相信在本书的帮助下,读者将能够轻松掌握 PyTorch 的使用,成为一名优秀的深度学习工程师。

4,601 个 Star492 个 ForkJupyter Notebook许可证因项目而异

秒懂

它是什么?
这是一份以 Jupyter Notebook 呈现的 PyTorch 中文教程,覆盖基础、CV/NLP/LLM 应用与 ONNX/TensorRT 部署。它像一本书,但代码和文档都在仓库里,适合想按图索骥的工程师。
适合谁用?
想系统入门 PyTorch 并一路走到部署环节的自学者、在校学生和跨领域工程师,适合把这份教程当作主干路线图,它把基础、CV/NLP/LLM 任务和 ONNX/TensorRT 串成了一条可跟读的路径。产品经理或只想要某个单一模型代码的人不适合,因为每个任务的讲解分散在 Notebook 里,没有按模型打包的即用脚本。
能商用吗?
未经许可不能。GitHub 在这个仓库里没有找到许可证文件;没有许可证,默认即「保留所有权利」:你可以阅读代码,但不能复用。使用前请看看 README,或先征得作者同意。
还在维护吗?
在维护。仓库最近一次提交在 1 天前。
用什么语言写的?
主要是 Jupyter Notebook(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

一份教程,三种读者,一个目标

这个仓库解决的是深度学习入门过程中的路径碎片化问题。README 把内容分成上中下三篇:上篇讲 PyTorch 基础,面向零基础和非科班读者;中篇覆盖 CV、NLP、LLM 的应用案例;下篇讲 ONNX 和 TensorRT 的部署。它试图让一个人从安装环境开始,一路走到模型量化部署,中间不需要切换多套资料。目标读者很明确,AI 自学者、学生、跨领域人士,甚至产品经理也能拿它了解技术全貌。但要注意,这不是一本薄手册,中篇里 CV 就有图像分类、分割、检测、跟踪、GAN、Diffusion 等八个任务,NLP 有五个任务,LLM 部分则分析 Qwen、ChatGLM、Baichuan 和 Yi 四个模型的部署。体量决定了它只能做引导,每个案例的深度有限。

从 Notebook 到一本书:仓库的真实形态

主语言是 Jupyter Notebook,这意味着教程的载体是交互式文档,而不是纯脚本。每个章节对应一个或多个 .ipynb 文件,读者可以逐格运行,看到中间输出。这种形式对教学友好,但对工程复用不友好。想直接跑某个模型,你得先打开 Notebook,把代码段拼出来。README 提到配套代码和在线阅读站点,在线版是 HTML 渲染的静态页面,适合通读,但动手时还是要回到仓库。仓库里还有一个 scripts/gen_star_history.py,它配合 GitHub Actions 每 7 天自动更新 Star 历史图,这个细节说明作者在意社区数据,但它跟教程内容无关。v1.0.0 发布于 2024 年 5 月,标签是 PDF 和 epub 发布,说明作者把内容固化成了一本书的形态。

CV 到 LLM:案例的广度和真实代价

中篇是仓库的核心卖点。CV 部分覆盖八大任务,从分类到图像检索,每个任务都有对应项目代码。NLP 部分从 RNN 讲到 GPT,包含文本分类、机器翻译、命名实体识别等五个任务。LLM 部分则直接分析四个国产开源模型,Qwen、ChatGLM、Baichuan、Yi,还附带 GPT Academic 这个学术优化应用。广度令人印象深刻,但代价是每个案例的讲解深度可能只够跑通,不够深入调优。例如 Diffusion 生成和 DeepSORT 目标跟踪出现在 topics 里,但 README 没有说明这些任务的代码是否依赖特定数据集或预训练权重。读者需要自己检查每个 Notebook 的依赖项。一个实际风险是,LLM 模型迭代很快,仓库分析的 Qwen 和 ChatGLM 版本可能落后于当前主流版本,部署代码未必能直接用于最新模型。

部署章节:ONNX 与 TensorRT 的实际分量

下篇把重点放在推理部署,这是很多教程缺失的部分。README 明确说要从 PyTorch 这个训练框架中剥离出来,介绍 ONNX 和 TensorRT 的原理与使用,并且借助 TensorRT 详细分析 PTQ 和 QAT 量化。这个定位很实在,因为训练和部署之间的鸿沟常常是新人最困惑的地方。但仓库没有给出具体的部署代码示例片段,只描述了章节内容。从目录结构看,部署相关 Notebook 应该包含模型导出、引擎构建和精度对比的步骤。一个需要读者自己验证的问题是,TensorRT 的版本兼容性很挑剔,Notebook 里用的 TensorRT 版本是否匹配你本机的 CUDA 和显卡,只有运行了才知道。量化部分,PTQ 和 QAT 的概念讲解可能足够,但实际工程里的校准数据集选择和精度损失分析,需要更多外部资料补充。

运行前的现实检查:环境与依赖

仓库没有提供 requirements.txt 或 environment.yml 这类一键安装文件,README 也没有列出 PyTorch 版本要求。这意味着你需要自己搭建环境。通常做法是安装 Anaconda,创建虚拟环境,再按每个 Notebook 的 import 语句逐个安装缺失包。这不算难,但会花时间。教程的上篇讲环境搭建,但具体命令在 Notebook 里,不是 README 里,所以你得先能打开 Jupyter 才能看到安装说明。一个更实际的问题是,PyTorch 版本差异会导致 API 变化,仓库最后推送是 2026 年 9 月,但 v1.0.0 是 2024 年 5 月发布的,期间 PyTorch 可能有多次小版本更新。如果你用最新的 PyTorch 2.x 运行旧 Notebook,某些 API 可能需要调整。建议先挑一个 CV 分类的 Notebook 试跑,确认环境没问题,再推进到 LLM 或 TensorRT 部分。

许可证与商业使用的分界线

README 末尾明确写了知识共享署名-非商业性使用 4.0 国际许可协议,即 CC BY-NC 4.0。这个许可证允许你自由分享和改编,但有两个前提:署名,以及不得用于商业目的。对个人学习和教学,这没问题。但如果你是公司内部培训,或者想把它改编成付费课程,那就越界了。仓库没有 LICENSE 文件,元数据里许可证字段是 unknown,但 README 的声明已经足够清楚。另一个细节是,作者在 README 里直接要求读者点 Star 鼓励,这种请求很常见,但它提醒你,这个项目的维护动力部分来自社区认可。如果你要基于它做二次开发,必须保留署名,并且不能从中直接获利。这不是法律建议,只是对文本声明的转述。

与同类教程的差异:书的结构,代码的魂

市面上 PyTorch 中文教程不少,但多数是纯理论书或单一任务实战。这个仓库的独特之处在于它刻意模仿一本书的编排,上篇基础,中篇应用,下篇部署,而且每篇都配有可运行的 Notebook。比较接近的替代品是《动手学深度学习》的 PyTorch 版本,它也有 Notebook 和在线文档,但它的重点在算法原理和数学推导,部署部分很薄。另一个方向是 Fast.ai 的教程,它强调自顶向下,先跑通再理解,但它是英文的,且不涉及 TensorRT 这类工业部署工具。这个仓库的取舍是,它牺牲了理论深度,换来了从训练到部署的完整链路。如果你已经懂深度学习基础,只想看某个任务的实现,直接去 Papers with Code 可能更高效。但如果你想要一条有顺序的路线,这份教程的结构比零散博客更系统。

编辑结论

想系统入门 PyTorch 并一路走到部署环节的自学者、在校学生和跨领域工程师,适合把这份教程当作主干路线图,它把基础、CV/NLP/LLM 任务和 ONNX/TensorRT 串成了一条可跟读的路径。产品经理或只想要某个单一模型代码的人不适合,因为每个任务的讲解分散在 Notebook 里,没有按模型打包的即用脚本。非商业用途是硬约束,CC BY-NC 4.0 意味着任何商业培训、公司内部付费课程或商业产品集成都不能直接使用其内容。动手前先核对两点:一是仓库默认分支的 Notebook 是否能在你的 CUDA 版本上直接运行,二是 v1.0.0 发布后是否有针对 PyTorch 2.x 的 API 变动未同步更新。这份教程的价值在于覆盖面,而不是每个案例的深度,把它当索引和起步代码,别当唯一参考。

官方来源

  1. Issues
  2. Project website
  3. README
  4. Releases
  5. TingsongYu/PyTorch-Tutorial-2nd on GitHub
社区笔记

社区笔记