Skip to content

Commit cf0c8c0

Browse files
authored
Improve the description for debug mode
1 parent aa556ba commit cf0c8c0

File tree

1 file changed

+10
-14
lines changed

1 file changed

+10
-14
lines changed

chapters/hello.md

Lines changed: 10 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -109,17 +109,13 @@ Flask 通过读取这个环境变量值对应的模块寻找要运行的程序
109109

110110
## 管理环境变量
111111

112-
现在在启动 Flask 程序的时候,我们通常要和两个环境变量打交道:`FLASK_APP``FLASK_ENV`。因为我们的程序现在的名字是 app.py,暂时不需要设置 `FLASK_APP``FLASK_ENV` 用来设置程序运行的环境,默认为 `production`。在开发时,我们需要开启调试模式(debug mode)。调试模式可以通过将系统环境变量 `FLASK_ENV` 设为 `development` 来开启。需要注意的是'FLASK_ENV'从Flask2.3开始将不会被支持,Flask用'FLASK_DEBUG'替代了它。调试模式开启后,当程序出错,浏览器页面上会显示错误信息;代码出现变动后,程序会自动重载。
112+
现在在启动 Flask 程序的时候,我们通常要和两个环境变量打交道:`FLASK_APP``FLASK_DEBUG`。因为我们的程序现在的名字是 app.py,暂时不需要设置 `FLASK_APP``FLASK_DEBUG` 用来开启调试模式(debug mode)。调试模式开启后,当程序出错,浏览器页面上会显示错误信息;代码出现变动后,程序会自动重载。
113113

114-
下面是手动设置环境变量 `FLASK_ENV`/`FLASK_DEBUG` 来开启调试模式的示例:
114+
下面是手动设置环境变量 `FLASK_DEBUG` 来开启调试模式的示例:
115115

116-
Flask 2.3之前
117116
```bash
118-
$ export FLASK_ENV=development # 注意在 Windows 系统使用 set 或 $env: 替代 export,参考前面的示例
119-
```
120-
Flask 2.3之后
121-
```bash
122-
$ export FLASK_DEBUG=TRUE # 注意在 Windows 系统使用 set 或 $env: 替代 export,参考前面的示例
117+
(env) $ export FLASK_DEBUG=1 # 注意在 Windows 系统使用 set 或 $env: 替代 export,参考前面的示例
118+
(env) $ flask run
123119
```
124120

125121
为了不用每次打开新的终端会话都要设置环境变量,我们安装用来自动导入系统环境变量的 python-dotenv:
@@ -140,20 +136,20 @@ $ touch .env .flaskenv
140136
.env
141137
```
142138

143-
在新创建的 .flaskenv 文件里,我们写入一行 `FLASK_ENV=development`,将环境变量 `FLASK_ENV` 的值设为 `development`,以便开启调试模式:
139+
在新创建的 .flaskenv 文件里,我们写入一行 `FLASK_DEBUG=1`,将环境变量 `FLASK_DEBUG` 的值设为 `1`,以便开启调试模式:
144140

145-
Flask2.3之前
146141
```bash
147142
# .flaskenv 文件
148-
FLASK_ENV=development
143+
FLASK_DEBUG=1
149144
```
150145

151-
Flask2.3之后
146+
顺便说一句,如果你安装的 Flask 版本是 2.3 或更高版本,则可以直接使用 `--debug` 命令行选项来开启调试模式,即:
147+
152148
```bash
153-
# .flaskenv 文件
154-
FLASK_DEBUG=TRUE
149+
(env) $ flask run --debug
155150
```
156151

152+
157153
## 实验时间
158154

159155
在这个小节,我们可以通过做一些实验,来扩展和加深对本节内容的理解。

0 commit comments

Comments
 (0)