第 1 章：准备工作
在通过这本书学习 Flask 开发前，我假设你已经了解了 Python 和 HTML 的基础知识。如果还没有，那么可以先从下面这些在线资源入手：
这个教程对你的 Python 版本或操作系统没有要求：你的 Python 版本可以是 2.7，也可以是 3.3 及以上版本。电脑的操作系统可以是 Windows，也可以是 macOS 或 Linux。
安装编辑器和浏览器
对于编辑器来说，每个人都有不同的偏好，你可以自由选择。可以选择功能丰富的IDE（集成开发环境），比如 PyCharm；也可以选择相对轻量的编辑器，比如 Atom 或 Sublime Text。浏览器建议使用 Firefox 或 Chrome。
使用命令行
在本书中，你需要使用命令行窗口来执行许多操作。你可以使用 Windows 下的 cmd.exe，或是 macOS 和 Linux 下的终端（Terminal）。下面我们执行一个最简单的
whoami 命令（即 Who Am I？）：1
$ whoami
2
greyli
Copied!
这个命令会打印出当前计算机用户的名称。其他常用的命令还有
cd 命令，用来切换目录（change directory）；mkdir 命令，用来创建目录（make directory）。在不同的操作系统上，执行某个操作的命令可能会有所不同，在必要的地方，书里会进行提示。我们先来为我们的程序创建一个文件夹：
1
$ mkdir watchlist
2
$ cd watchlist
Copied!
除非特别说明，从现在开始，本书假设你的工作目录将是在项目的根目录，即 watchlist/ 目录。
为了确保你已经正确安装了 Python，可以执行下面的命令测试是否有报错：
1
$ python --version
2
Python 2.7.11
Copied!
在 Linux 和 macOS 中，对应 Python 3 版本的命令将会是
python3（类似的，Python 3 对应的 pip 命令为 pip3）：1
$ python3 --version
2
Python 3.8.3
Copied!
对于 Windows（非 WSL） 用户，如果你对不同系统下终端命令的区别不熟悉，可以考虑在这个教程的学习过程中使用 Git Bash（安装 Git for Windows 后附带的终端程序，下一节会介绍 Git 安装） 来代替系统自带的 cmd.exe 或 Powershell。Git Bash 支持一些在 Linux 或 macOS 下才能使用的命令（程序），比如 ls、cat、nano、ssh 等，这些命令我们在后面会用到。
提示 如果你打算在这个教程的学习中继续使用 cmd.exe 或 Powershell，那么需要注意下列命令的区别：
dir命令替代ls命令，使用type命令替代cat命令nano命令，你可以替换为其他已安装的编辑器命令，比如对于 VS Code，可以使用code命令。或者，你也可以直接使用编辑器的图形界面创建文件并编辑。ssh、ssh-keygen）可以在控制面板中额外安装（Docs）；旧版本 Windows 可以安装第三方 OpenSSH 客户端，比如 Putty，或直接使用 Git Bash。
使用 Git
如果你还不熟悉 Git 也没关系，可以先按照书中的命令去做，有时间再去了解原理。现在要做的第一件事就是在你的电脑上安装 Git（可以执行
git --help 命令检查是否已经安装，没有提示“命令未找到（Command not found）”则表示已安装）。安装后可以在命令行先使用使用下面的命令查看版本，没有报错则表示已正确安装：
1
$ git --version
2
git version 2.17.1
Copied!
为了让 Git 知道你是谁，以便在提交代码到版本仓库的时候进行记录，使用下面的命令设置你的信息：
1
$ git config --global user.name "Grey Li" # 替换成你的名字
2
$ git config --global user.email "[email protected]" # 替换成你的邮箱地址
Copied!
现在为我们的项目文件夹创建一个 Git 仓库，这会在我们的项目根目录创建一个 .git 文件夹：
1
$ git init
2
Initialized empty Git repository in ~/watchlist/.git/
Copied!
Git 默认会追踪项目文件夹（或者说代码仓库）里所有文件的变化，但是有些无关紧要的文件不需要记录变化，我们在项目根目录创建一个 .gitignore 文件，在文件中写入忽略文件的规则。因为文件内容比较简单，我们直接在命令行使用 nano 来创建：
1
$ nano .gitignore
Copied!
在 nano 编辑界面写入常见的可忽略文件规则：
1
*.pyc
2
*~
3
__pycache__
4
.DS_Store
Copied!
使用 Control + O 和 Enter 键保存，然后按下 Control + X 键退出。在后续章节，对于简单的文件，都会使用 nano 创建，这部分操作你也可以使用编辑器图形界面来完成。
将程序托管到 GitHub（可选）
这一步是可选的，将程序托管到 GitHub、GitLab 或是 BitBucket 等平台上，可以更方便的备份、协作和部署。这些托管平台作为 Git 服务器，你可以为本地仓库创建远程仓库。
设置 SSH 密钥
一般情况下，当推送本地改动到远程仓库时，需要输入用户名和密码。因为传输通常是通过 SSH 加密，所以可以通过设置 SSH 密钥来省去验证账号的步骤。
首先使用下面的命令检查是否已经创建了 SSH 密钥：
1
$ cat ~/.ssh/id_rsa.pub
Copied!
如果显示“No such file or directory”，就使用下面的命令生成 SSH 密钥对，否则复制输出的值备用：
1
$ ssh-keygen
Copied!
一路按下 Enter 采用默认值，最后会在用户根目录创建一个 .ssh 文件夹，其中包含两个文件，id_rsa 和 id_rsa.pub，前者是私钥，不能泄露出去，后者是公钥，用于认证身份，就是我们要保存到 GitHub 上的密钥值。再次使用前面提到的命令获得文件内容：
1
$ cat ~/.ssh/id_rsa.pub
2
ssh-rsa AAAAB3Nza...省略 N 个字符...3aph [email protected]
Copied!
选中并复制输出的内容，访问 GitHub 的 SSH 设置页面（导航栏头像 - Settings - SSH and GPG keys），点击 New SSH key 按钮，将复制的内容粘贴到 Key 输入框里，再填一个标题，比如“My PC”，最后点击“Add SSH key”按钮保存。
创建远程仓库
访问新建仓库页面（导航栏“+” - New repository），在“Repository name”处填写仓库名称，这里填“watchlist”即可，接着选择仓库类型（公开或私有）等选项，最后点击“Create repository”按钮创建仓库。
因为我们已经提前创建了本地仓库，所以需要指定仓库的远程仓库地址：
1
$ git remote add origin [email protected]:greyli/watchlist.git # 注意更换地址中的用户名
Copied!
这会为本地仓库关联一个名为“origin”的远程仓库，注意将仓库地址中的“greyli”换成你的 GitHub 用户名。
如果还没有创建本地仓库，则可以直接将远程仓库克隆到本地（这会在当前目录创建一个名为 watchlist 的文件夹）：
1
$ git clone [email protected]:greyli/watchlist.git # 注意更换地址中的用户名
Copied!
创建虚拟环境
虚拟环境是独立于 Python 全局环境的 Python 解释器环境，使用它的好处如下：
- 保持全局环境的干净
- 指定不同的依赖版本
- 方便记录和管理依赖
我们将使用 Python 3 内置的 venv 模块创建虚拟环境，使用下面的命令即可为当前项目创建一个虚拟环境：
1
$ python -m venv env # Windows
Copied!
或：
1
$ python3 -m venv env # Linux 和 macOS
Copied!
提示 上述命令的最后一个参数是虚拟环境名称，你可以自由定义，比如 venv、env、.venv，或是“项目名-venv”，这里使用了 env。
这会在当前目录创建一个包含 Python 解释器环境的虚拟环境文件夹，名称为 env。
如果你使用 Python 2，则需要安装 virtualenv 来代替 venv：
1
$ pip install virtualenv # Windows
Copied!
或：
1
$ sudo pip install virtualenv # Linux 或 macOS
Copied!
创建虚拟环境时使用下面的命令：
1
$ virtualenv env
Copied!
激活虚拟环境
创建虚拟环境后，我们可以使用下面的命令来激活虚拟环境（通过执行/“source”激活脚本实现）：
1
$ env\Scripts\activate # Windows
Copied!
提示 如果你在 Windows 中使用 Git Bash，则需要使用. env/Scripts/activate命令
或：
1
$ . env/bin/activate # Linux 或 macOS
Copied!
这时命令提示符前会显示虚拟环境的名称，表示已经激活成功：
1
(env) $
Copied!
在激活虚拟环境后，无论操作系统和 Python 版本，都可以统一使用
python 和 pip 命令来调用当前虚拟环境内的 Python 和 pip 程序/二进制文件。此时执行 python 或 pip 命令指向的程序和激活脚本在同一个目录下，在 Windows 下所在目录为 env\Scripts\，Linux 和 macOS 下所在目录为 env/bin/。最后，执行
deactivate 即可退出虚拟环境：1
(env) $ deactivate
2
$
Copied!
注意 除了 Git 相关命令外，除非特别说明，本书后续的所有命令均需要在激活虚拟环境后执行。
安装 Flask
激活虚拟环境后，使用下面的命令来安装 Flask：
1
(env) $ pip install flask
Copied!
这会把 Flask 以及相关的一些依赖包安装到对应的虚拟环境。
提示 如果你没有使用虚拟环境，记得将 Flask 更新到最新版本（pip install -U flask）。
本章小结
当你进行到这里，就意味这我们已经做好学习和开发 Flask 程序的全部准备了。使用
git status 命令可以查看当前仓库的文件变动状态：1
$ git status
Copied!
下面让我们将文件改动提交进 Git 仓库，并推送到在 GitHub 上创建的远程仓库：
1
$ git add .
2
$ git commit -m "I'm ready!"
3
$ git push -u origin master # 如果你没有把仓库托管到 GitHub，则跳过这条命令，后面章节亦同
Copied!
这里最后一行命令添加了
-u 参数，会将推送的目标仓库和分支设为默认值，后续的推送直接使用 git push 命令即可。在 GitHub 上，你可以通过 https://github.com/你的用户名/watchlist 查看你的仓库内容。进阶提示
Last modified 1yr ago