# Python 实战开发指南

```{image} https://www.python.org/static/community_logos/python-logo-generic.svg
:alt: Python Logo
:width: 300px
:align: center
```

欢迎阅读 **Python 实战开发指南**！本文档专注于 Python 开发中程序员**易错**和**易忽略**的知识点，偏重于 Python 擅长的领域：**数据分析**、**AI 编程**、**Web 开发**。

## 目标读者

- 有一定编程基础，想深入学习 Python 的开发者
- 从其他语言转向 Python 的程序员
- 希望避免常见陷阱，写出 Pythonic 代码的工程师

## 文档特点

- **实用导向**：每个知识点都有实际应用场景
- **避坑指南**：重点讲解易错、易混淆的概念
- **最佳实践**：提供业界推荐的编码方式
- **代码示例**：可直接运行的完整代码

## 内容概览

```{toctree}
:maxdepth: 2
:caption: 目录
:numbered:

1. Python 核心语法 <core/index>
2. 并发异步编程 <async/index>
3. Web 开发 <web/index>
4. Python 陷阱 <traps/index>
```

## 快速导航

::::{grid} 2
:gutter: 2

:::{grid-item-card} 🐍 Python 核心语法
:link: core/index
:link-type: doc

深入理解 Python 核心概念，包括数据模型、函数式编程、面向对象等。
:::

:::{grid-item-card} ⚡ 并发异步编程
:link: async/index
:link-type: doc

掌握 asyncio、多线程、多进程，理解 GIL 的影响。
:::

:::{grid-item-card} 🌐 Web 开发
:link: web/index
:link-type: doc

FastAPI 和 Flask 框架实战，RESTful API 设计。
:::

:::{grid-item-card} ⚠️ Python 陷阱
:link: traps/index
:link-type: doc

常见错误、性能陷阱、内存泄漏等问题及解决方案。
:::

::::

## 环境要求

- Python 3.10+
- 建议使用虚拟环境

```bash
# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt
```

## 参考资源

- [Python 官方文档](https://docs.python.org/3/)
- [FastAPI 文档](https://fastapi.tiangolo.com/)
- [Flask 文档](https://flask.palletsprojects.com/)
- [Real Python](https://realpython.com/)