Python Guide：一份长期维护的最佳实践手册

realpython/python-guide 在 GitHub 上已经拿到 29,643 Star。

Real Python 团队维护的这份指南，给日常写 Python 的人提供了一份安装、配置和使用的参考手册。无论刚接触这门语言，还是已经写了很多年，这份文档都能提供有价值的建议。

1、这项目是什么

它是一份观点鲜明的最佳实践清单，覆盖从环境搭建到项目部署的完整链路。

新手可以用它避开常见的坑，老手可以用它快速确认某个场景下的推荐做法。项目自述文件标注了仍在积极开发中，内容在持续迭代。

2、覆盖了哪些内容

安装部分按平台区分，讲清楚不同操作系统下的 Python 版本管理和安装方式。Windows、macOS、Linux 各自有对应的指引。

包管理单独讲了 pip 的用法和配置，包括怎样处理依赖冲突和版本锁定。虚拟环境有 Virtualenv 的详细说明，解释了为什么应该用虚拟环境以及怎样搭建。

打包和分发这块覆盖了 Py2app、Py2exe、bbfreeze、pyInstaller 等常见工具，各自适用的场景也做了说明。

科学计算和数据分析的栈也包含在内：Numpy、scipy、statpy、pyplot、matplotlib 的引入和使用方式都有说明。

Web 开发的服务器配置、各框架的部署工具、模块推荐按用途分组列举。文档写作和测试流程也有专门章节，测试部分涉及 Jenkins 和 tox 的配置指南。版本控制方面还讲了怎样在 git 里操作 hg。

3、为什么值得看

这份指南由 Real Python 社区维护。Real Python 是 Python 教育领域的老牌站点，内容更新和审核机制都比较成熟。

它的结构是手册式的。你不需要从头读到尾，遇到具体问题时翻到对应章节即可。这种组织方式对工作中需要快速查证的开发者很友好。

项目提供了在线版本，地址是 docs.python-guide.org，可以直接浏览器阅读。如果你更习惯本地查看，也可以直接阅读源码。两种形式的内容基本同步。

4、适合哪些人

• 刚入门 Python，想建立正确工程习惯的新手
• 需要在不同平台间切换、对环境配置拿不准的开发者
• 做技术选型时想参考社区共识的团队
• 负责培训新人、需要一份标准化参考资料的技术负责人
• 写 Python 有一段时间、想确认自己习惯是否跟社区推荐一致的人

29,643 个 Star 反映了社区对这份指南的认可。如果你写 Python，这份文档值得放进书签栏。

个 Star 反映了社区对这份指南的认可。如果你写 Python，这份文档值得放进书签栏。