Flask 安装
在正式启动Flask应用代码的编写工作这一项任务之前, 我们首先需要对相关的运行环境进行必要的准备操作, 并且紧接着要把Flask这个工具库给安装好。
关于Flask的安装, 其难度系数还是比较低的。
Flask是属于一个库的东西, 所以首先得要让你自己的计算机上面已经成功安装了那个东西才行。
版本要求
Flask 3.x 这个版本, 它要求的 的版本嘛, 得是那种三点九以及比三点九更新的版本号才行。
要是你这边还没把那软件给装上, 那你完全可以去那个地方把它下载安装下来。
在完成安装操作之后, 需要打开终端界面来进行后续的验证步骤。
$ python3 --version
Python 3.12.3
$ pip3 --version
pip 24.0 from /usr/lib/python3.12/site-packages/pip (python 3.12)
macOS 和大多数 Linux 发行版已预装 3。如果你用的是 ,安装时请勾选 Add to PATH 选项。
虚拟环境
大家现在做项目的时候, 通常会用一个虚拟环境, 这是一个很普遍的做法, 它的作用是为每一个单独的项目去创建出一个单独的, 属于这个项目的包的空间。
为什么要用虚拟环境
你现在假如手边有这么两个项目, 一个是被叫做项目A的东西, 它需要用到.0这个版本来进行运作, 另一个呢是被叫做项目B的那个东西, 它是需要用到.3这个版本的。
要是你选择了全局进行安装的话, 那个两个不同版本的 Flask 就会发生互相冲突的情况。
虚拟环境让每一个项目都拥有独自的、不互相干扰的依赖包。
你可以直接使用自带的venv模块来创建一个虚拟环境, 这样做的一个好处是根本不需要去寻找并安装任何其他的额外工具。
创建虚拟环境
第一步是把项目目录给创建出来, 接着呢, 再去把这个项目目录里面创建的虚拟环境也给它弄好。
$ mkdir runoob-flask-test
$ cd runoob-flask-test
$ python3 -m venv .venv
<.venv> 这个名称是专门用来作为虚拟环境目录使用的, 实际上用户完全可以按照自己的喜好去更改它的名字, 不过在程序员社区里面, 使用 <.venv> 这种写法的约定俗成的情况是非常普遍, 也是大家最经常遇到的。
用户需要知道的是, 在操作系统当中如何来激活虚拟环境的操作命令。
macOS / Linux
是\.venv/bin/这个路径, 或者是说\.venv/bin/那个目录。
(CMD)
.venv\\
()
.venv\\.ps1
等激活成功之后, 终端提示符的前面会出现一个(.venv)这样的标识东西, 这个情况就说明虚拟环境已经起到作用啦。
$ . .venv/bin/activate
(.venv) $ # <-- 提示符变了,说明虚拟环境已经激活
退出虚拟环境
在开发任务彻底完成之后, 操作人员应当执行 这个命令, 以此来顺利退出当前的操作界面:
(.venv) $ deactivate
$

每当用户开启一个全新的终端界面会话之际, 倘若想要启动并运用名为Flask这一特定框架的话, 那么就必须执行再次的虚拟运行环境激活操作指令才行。
另外还可以使用uv这个包与环境管理工具, 参考。
# 使用指定 Python 版本创建虚拟环境
uv venv --python 3.12
激活虚拟环境:
macOS / Linux
source .venv/bin/activate
Windows(PowerShell)
.venv\Scripts\activate
执行安装Flask的动作。
当那个被称为虚拟环境的玩意儿已经被成功运行起来之后, 大家应当操作那个名字叫做 pip 的工具, 来进行一个名叫 Flask 的软件的安装动作。
(.venv) $ pip install Flask
在把东西全部装好之后, 接下来我们要进行的操作就是验证一下 Flask 是不是真的就安装成功了, 具体的做法是:
flask --version
请用户提供需要改写的句子内容。
Python 3.9.6
Flask 3.0.0
Werkzeug 3.1.5
同样, 还可以通过下面这些代码的内容来做到验证。
from importlib.metadata import version
flask_version = version("flask")
print(flask_version)
一旦执行取得了预想中的成效, 屏幕上面将会展示出一种类似于下面的版本号样子。
3.1.3
这个时候, 以下这些依赖包也被一起装上了: 、、Click、、。
可以选择进行安装操作, 该步骤为可选项。
你可以借助那个点加 env 的文件以及点加点的符号, 来进行对环境变量的管理操作, 以此来让使用 Flask 命令的过程得到简化。
(.venv) $ pip install python-dotenv
虽然它不是必须安装的, 但是在实际开发的过程中, 强烈建议进行安装。这样做让你省去每次都要输入 --app 这个参数的麻烦, 同时也方便于团队内部的成员共享环境配置。
项目目录结构
在进行具体的代码编写工作之前, 事先弄清楚一个标准的 Flask 项目的目录结构情况, 是一件十分有帮助的事情:
myflaskapp/
├── .venv/ # 虚拟环境(不要提交到 Git)
├── app.py # 应用入口文件
├── templates/ # Jinja2 模板文件目录
├── static/ # CSS、JS、图片等静态文件目录
├── .flaskenv # Flask 环境变量(可选)
└── .gitignore # 忽略 .venv 等不需要提交的文件
虚拟环境目录 .venv 是不应该被提交到 git 里面的, 在 . 里面添加 .venv/ 就可以实现了。
开发环境
关于开发环境的推荐情况。
国内, 阿里和字节这两家公司也都在基于 VS Code 这一软件开发平台的基础之上开发了自家的 AI 集成开发环境。
字节 Trae
由字节跳动所精心推出的, 那个被称作是新一代的人工智能开发环境。
访问 →
阿里 Qoder
由阿里巴巴所推出的那个用来进行编程的智能开发工具, 是在视觉工作室代码这个基础之上进行了深度的定制和处理。
访问 →