Help us learn about your current experience with the documentation. Take the survey.

在 GitLab 中开始使用 Python

入门指南

本指南帮助非 Python 开发者快速高效地开始使用 Python。

设置 Python：
- 从官方 Python 网站安装 Python。
- 也可以使用 Mise 安装 Python：
```
mise use python@3.14
```
- 虽然 macOS 预装了 Python，但强烈建议安装并使用独立的 Python 版本
安装 Poetry 进行包管理：
- Poetry 是一个现代的、专门针对 Python 的依赖管理器，简化了打包和依赖处理。要安装它，请运行：
```
 curl --silent --show-error --location "https://install.python-poetry.org" | python3 -
```
- 也可以使用 Mise 安装 Poetry：
```
mise install poetry
```
- 请务必阅读 Poetry 安装指南了解完整的安装详情
- 安装完成后，使用 Poetry 创建一个新的 Python 项目：
```
poetry new my_project
cd my_project
poetry install
```
运行和调试现有代码
- 通过阅读 README.md 熟悉项目结构。
- 使用 pdb 或 IDE 调试功能等工具来调试代码。示例：
```
poetry shell
python -m pdb <file_name>.py
```
- PyCharm 和 VSCode 都提供了优秀的代码调试工具

如果您是 Python 新手或想更新知识，本节提供了学习该语言的各种材料。

Python 之禅 Python 之禅 - PEP 20 - 是必读内容，它塑造了您对 Python 的思考方式和编写 “Pythonic” 代码的方式。
Python 速查表 一份全面的参考资料，涵盖核心 Python 语法、内置函数和实用库。这适合初学者和有经验的用户，他们希望快速了解 Python 的核心特性。
100 页 Python 入门 简明指南提供了对 Python 的直接介绍，涵盖了有效开始编程所需的所有基础知识。这是一个对初学者友好的选择，涵盖了从语法到调试和测试的所有内容。
用 Y 分钟学习 X：Python 一个非常简短的高级介绍，直接切入 Python 的核心语法和特性，使其成为转向 Python 的开发者的宝贵快速入门指南。
Exercism Python 轨道 使用 Exercism 的 Python 轨道作为学习 Python 概念和最佳实践的基础。Exercism 提供实践练习和导师支持，使其成为通过编程练习和反馈掌握 Python 的优秀资源。

在构建 Python API 时，我们使用 FastAPI 和 Pydantic。要开始构建和审查这些技术，请参考以下资源：

FastAPI 文档 FastAPI 是一个使用 Python 构建 API 的现代 Web 框架。本资源将帮助您学习如何创建快速高效的 Web 应用程序和 API。FastAPI 特别适合构建高性能和可扩展的 Python 应用程序。
Pydantic 文档 Pydantic 是一个使用 Python 类型注解进行数据验证和设置管理的 Python 库。学习如何将 Pydantic 集成到您的 Python 项目中，以便更轻松地进行数据验证和管理，特别是在使用 FastAPI 时。

我们使用 pytest 测试 Python 代码。要了解有关使用 pytest 编写和运行测试的更多信息，请参考以下资源：

pytest 文档 pytest 是一个流行的 Python 测试框架，使编写简单可扩展的测试变得容易。本资源提供了有关如何使用 pytest 编写和运行测试的全面文档，包括 fixtures、插件和测试发现。
使用 pytest 进行 Python 测试（书籍） 这本书是使用 pytest 测试 Python 代码的综合指南。它涵盖了从编写测试的基础知识到 fixtures、插件和测试组织等高级主题。
Python 函数转流程图 这个项目可以处理任何 Python 函数，并自动创建一个显示代码工作原理的可视化流程图。

一个供开发者协作学习 Python、FastAPI 和 Pydantic 的空间，专注于构建真实世界的应用程序。

有关持续更新和讨论，请参考 Python 学习小组的跟踪和提议会议问题。

小组学习的核心主题：

基础 Python 语法：
- 学习 Python 概念，如变量、函数、循环和条件语句。
- 在 Exercism Python 轨道练习。
FastAPI 和 Pydantic：
- 学习如何使用 FastAPI 构建 API 并使用 Pydantic 验证数据。
- 关键资源：
  - FastAPI 文档
  - Pydantic 文档

所有审查和学习小组会议都将被录制并分享，涵盖 Python、FastAPI 和 Pydantic 中的关键概念。这些录像是回顾主题或错过会议时跟上的好资源。

将任何上传的视频添加到 Python 资源播放列表中。

Python 的一对一导师制是可行的且受到鼓励。有关如何开始导师制的更多信息，请参阅 GitLab 导师手册。