https://github.com/Prodesire/Python-Guide-CN

Python最佳实践指南

Python最佳实践指南中文版

项目翻译自 Hitchhiker's Guide to Python。

Readthedocs文档地址 Python最佳实践指南中文版。

---

本指南目前持续不断地更新与完善。这份主要是自我见解的指南旨在为Python初学者和 专家提供一个关于Python安装、配置、和日常使用的最佳实践手册。

主题包括:

• 不同平台和系统上的安装
• Py2app, Py2exe, bbfreeze, pyInstaller
• Pip
• Numpy, scipy, statpy, pyplot, matplotlib
• Virtualenv
• Fabric
• 优秀的模块推荐，按主题/目的分类
• 在哪些场景下使用哪些模块
• 服务器配置 & 不同的web框架和工具
• 文档: 写文档
• 测试: Jenkins & tox 指南
• 如何更方便地通过 git 连接 hg

如果你不习惯阅读reStructuredText形式的文档, 这里有一份同步更新的 HTML版文档，请戳它。

使用指南

1. 下载zip文件或clone到本地，并进入到项目根目录
2. 打开命令行，运行 pip install -r requirements.txt 安装依赖
3. 打开命令行，运行 make html ; 或者（针对Windows）运行makehtml.bat
4. 上述步骤自动在根目录下生成build文件夹，打开./build/html/index.html即可浏览文档

或者

• 直接访问 Python最佳实践指南中文版。

---

翻译进度（完成）

Getting Started（开始吧）（完成）

• Picking an Interpreter（选择一个解释器）（完成）
• Properly Install Python（正确地安装Python）（完成）

Writing Great Code（写出优雅的代码）（完成）

• Structuring Your Project（结构化你的工程）（完成）
• Code Style（代码风格）（完成）
• Reading Great Code（阅读好的代码）（完成）
• Documentation（文档）（完成）
• Testing Your Code（测试你的代码）（完成）
• Logging（日志）（完成）
• Common Gotchas（常见陷阱）（完成）
• Choosing a License（选择一个许可）（完成）

Scenario Guide（场景/方案指南）（完成）

• Network Applications（网络应用）（完成）
• Web Applications（Web 应用）（完成）
• HTML Scraping（HTML 抓取）（完成）
• Command-line Applications（命令行应用）（完成）
• GUI Applications（GUI应用）（完成）
• Databases（数据库）（完成）
• Networking（网络）（完成）
• Systems Administration（系统管理）（完成）
• Continuous Integration（持续集成）（完成）
• Speed（速度）（完成）
• Scientific Applications（科学应用）（完成）
• Image Manipulation（图像处理）（完成）
• XML parsing（XML解析）（完成）
• JSON（JSON）（完成）
• Cryptography（密码学）（完成）
• Interfacing with C/C++ Libraries（与C/C++库交互）（完成）
• Machine Learning（机器学习）（完成）
• Data Serialization（数据序列化）（完成）

Shipping Great Code（部署优雅的代码）（完成）

• Packaging Your Code（打包你的代码）（完成）
• Freezing Your Code（冻结你的代码）（完成）

Development Environment（开发环境）（完成）

• Your Development Environment（你的开发环境）（完成）
• Virtual Environments（虚拟环境）（完成）
• Further Configuration of Pip and Virtualenv（Pip和Virtualenv的更多配置）（完成）

Additional Notes（额外关注）（完成）

• Introduction（介绍）（完成）
• The Community（社区）（完成）
• Learning Python（学习Python）（完成）
• Documentation（文档）（完成）
• News（新闻）（完成）

其他（完成）

• Contribute（贡献）（完成）
• License（许可证）（完成）
• The Guide Style Guide（风格指南指引）（完成）