正心全栈编程-文档站

Appearance

创建项目 ​

使用 poetry 虚拟环境管理项目 ​

poetry 入门完全指南

提示

请确保 Python 解释器版本在 3.10 以上

安装 poetry 虚拟环境

shell
pip install poetry

设置 poetry 虚拟环境创建在当前项目目录下

shell
poetry config virtualenvs.in-project true

初始化项目

shell
poetry init

进入 poetry 环境的指令

shell
poetry shell

项目启动 ​

从命令行启动项目 ​

注意：使用 .flaskenv 需要先安装 python-dotenv

shell
poetry add python-dotenv

相关命令参考：https://flask.palletsprojects.com/en/3.0.x/cli/

使用 python-dotenv 管理环境变量，从 .env 读取键值对，并将其添加到环境变量。

这个值可以在 .flaskenv 文件中设置，如果没有获取到，则使用默认值 development，对应的配置类即 DevelopmentConfig。

在项目根目录下分别创建两个文件：

  • .env 存储敏感信息的环境变量，比如一些私密的账户名与密码
  • .flaskenv 存储公开环境变量，比如 FLASK_APP。
shell
FLASK_DEBUG=True
FLASK_RUN_HOST='127.0.0.1'
FLASK_RUN_PORT=5000
FLASK_APP=app.py
  • FLASK_APP：项目启动的 app 对象所在的文件（可以是模块、包）
  • FLASK_DEBUG：是否开启调试模式（支持热更新）
  • FLASK_RUN_HOST：项目运行的 ip 地址
  • FLASK_RUN_PORT：项目运行的端口

@拓展：启动程序

当使用 flask run 命令启动程序时，Flask 的自动发现程序实例机制还包含另一种行为：Flask 会自动从环境变量 FLASK_APP 的值定义的模块中寻找名为 create_app() 或 make_app() 的工厂函数，自动调用工厂函数创建程序实例并运行。因为我们已经在 .flaskenv 文件中将 FLASK_APP 设为 app，所以不需要更改任何设置，继续使用 flask run 命令即可运行程序：

shell
flask run

如果你想设置特定的配置名称，最简单的方式是通过环境变量 FLASK_CONFIG 设置。另外，也可以使用 FLASK_APP 显式地指定工厂函数并传入参数：

python
FLASK_APP = "forum:create_app('development')"
  • forum：包名
  • create_app：方法名

从 pycharm 启动 ​

上课直接演示

使用 GIT 管理源代码 ​

初始化 git

shell
git init

配置当前项目git提交信息(可省略此步，如不配置则使用全局配置)

bash
git config user.name XXX
git config user.email XXX@xxx.com

添加忽略文件

bash
touch .gitignore

设置忽略文件内容(后续根据需要再添加)

.idea
.venv
*.py[cod]
*.log

添加所有文件到暂存区

bash
git add .

提交到本地仓库并填写注释

bash
git commit -m 'init'