### 如何在 VS Code 中安装和配置 Flask-SQLAlchemy 要在 Visual Studio Code (VS Code) 中安装并配置 Flask-SQLAlchemy，可以按照以下方法完成。 #### 1. 安装 Flask 和 Flask-SQLAlchemy 首先，在终端中通过 `pip` 命令来安装必要的库。打开命令提示符或终端窗口，并运行以下命令： ```bash pip install flask flask-sqlalchemy ``` 这一步确保了 Flask 及其 SQLAlchemy 扩展被成功安装到当前环境中[^2]。 如果正在使用虚拟环境，则需先激活它再执行上述命令。例如： ```bash source venv/bin/activate # Linux 或 macOS venv\Scripts\activate # Windows ``` #### 2. 创建基础项目结构 构建一个简单的 Flask 应用程序框架以便集成 SQLAlchemy。以下是推荐的标准目录布局[^4]: ``` flask-sqlalchemy-project/ ├── app/ │ ├── __init__.py │ ├── models.py │ └── routes.py ├── config.py ├── requirements.txt └── run.py ``` - **app/__init__.py**: 初始化 Flask 应用以及绑定 SQLAlchemy 对象。 ```python from flask import Flask from flask_sqlalchemy import SQLAlchemy db = SQLAlchemy() def create_app(): app = Flask(__name__) # 数据库 URI 配置示例 app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///project.db' app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False db.init_app(app) return app ``` - **config.py**: 存储数据库及其他重要参数的配置项。 ```python SQLALCHEMY_DATABASE_URI = "sqlite:///project.db" SQLALCHEMY_TRACK_MODIFICATIONS = False ``` - **models.py**: 定义数据模型类。 ```python from app import db class User(db.Model): id = db.Column(db.Integer, primary_key=True) username = db.Column(db.String(80), unique=True, nullable=False) email = db.Column(db.String(120), unique=True, nullable=False) ``` - **run.py**: 主入口脚本用来启动服务器。 ```python from app import create_app app = create_app() if __name__ == '__main__': app.run(debug=True) ``` #### 3. 解决中文乱码问题 当涉及存储或检索含有汉字的数据时，可能遭遇编码错误。为了避免此情况发生，请确认以下几个方面已妥善处理[^1]: - MySQL 的字符集应设为 utf8mb4； - URL 字符串中的附加选项 charset=utf8； 修改后的数据库连接字符串如下所示： ```python app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://username:password@localhost/db_name?charset=utf8mb4' ``` #### 4. 使用 VS Code 调试功能 为了更高效地开发基于 Flask-SQLAlchemy 的应用，可启用调试模式并在 VS Code 内部设置断点追踪逻辑流。具体步骤包括但不限于调整 launch.json 文件内容以支持 Python Debugging 插件。 --- ###