从环境搭建到项目运行：Python 和 Flask 快速上手指南

Tue, 07 Jan 2025 20:27:00 +0800

最近在研究 RAG，免不了会使用到 Python，本文简单介绍下 Python 从环境的搭建到运行一个简单的 Web 项目。

环境

Python 中的包管理工具有 conda、pip、poetry、PyPI 等，Web 框架也有 Django、Flask、FastAPI ，为什么选择的是 poetry 和 Flask 呢？

因为现在研究的 RAGFlow 的源码中使用的就是 poetry 和 Flask 。带着目的去学习效率会高很多。

直接在官网下载安装就可以：https://www.python.org/downloads/，我很早前就安装了，一直没有升级，所以版本还是 3.11.7 。

如果你了解过 Python，一定知道 pip，但 pip 在包的依赖管理和版本冲突管理上做的不是很好，而 poetry 就是为了解决这两个问题而生。

我在本机是使用 pipx 来安装的 poetry ，先使用 homebrew 安装 pipx：

1
2


brew install pipx
pipx ensurepath

接着使用 pipx 安装 poetry，命令如下：

1

pipx 安装 poetry

安装完成后，可以通过以下命令验证 poetry 是否安装成功：

poetry --version

出现下图所示，说明安装成功：

可以使用 poetry 创建一个新的项目:

poetry new poetry-project

也可以在现有项目的目录中初始化 poetry：

cd exist-project
poetry init

使用 poetry 创建的项目目录如下：

在 pyproject.toml 文件中进行包版本的管理。这时如果我要给项目添加相关的依赖包，有两种方式：

直接使用 poetry 命令:

poetry add six:1.16.0

使用命令安装完成后，pyproject.toml 文件中会自动添加 six = “1.16.0” ，如下图：