Python解释器和pip需先在系统级安装并确保终端中可直接调用，通过python --version和pip list验证；若报错则需检查PATH配置，重装时务必勾选“Add Python to PATH”或手动添加安装路径及Scripts目录。
确认Python解释器和pip可用
VS Code本身不自带Python运行时，必须先装好系统级Python（建议3.9+），且确保python和pip命令在终端中可直接调用。打开VS Code内置终端（Ctrl + `），执行python --version和pip list验证。如果报“不是内部或外部命令”，说明PATH没配好——重装Python时务必勾选Add Python to PATH，或手动把Python安装目录（如C:\Users\xxx\AppData\Local\Programs\Python\Python311\）加进系统环境变量。
安装peewee并验证基础连接
在VS Code终端里运行pip install peewee即可。不需要额外驱动：SQLite开箱即用；若要用MySQL或PostgreSQL，再单独装pymysql或psycopg2。验证是否装对，新建一个test_db.py，写两行：
from peewee import SqliteDatabase
db = SqliteDatabase(':memory:') # 内存数据库，免文件清理
print(db.connect())运行无报错，说明peewee已就绪。注意别用peewee-2.2.1这种旧版tar包手动装——它不兼容Python 3.10+的语法特性，容易在Model.create_table()时报TypeError: 'NoneType' object is not callable。
在VS Code中启用Python扩展与正确解释器
必须安装微软官方Python扩展（ID：ms-python.python）。装完后按Ctrl+Shift+P，输入Python: Select Interpreter，从列表里选你刚装的那个Python路径（不要选conda或venv里没装peewee的环境）。否则即使pip install peewee成功，VS Code的IntelliSense仍会标红from peewee import *，调试也找不到模块。
- 如果项目用了虚拟环境，先激活它再装peewee：
python -m venv venv→venv\Scripts\activate（Windows）→pip install peewee - VS Code右下角状态栏会显示当前解释器路径，点它可快速切换
- 禁用其他Python插件（比如Pylance旧版或非官方Python支持），避免类型提示冲突导致
Model.select()方法无法自动补全
调试时数据库路径权限与相对路径陷阱
Peewee用SqliteDatabase('data.db')时，路径是相对于**当前工作目录**（不是.py文件所在目录）。VS Code默认以打开的文件夹为工作目录，但调试时可能变成用户主目录或空目录，导致OperationalError: unable to open database file。
- 解决办法：统一用绝对路径，例如
SqliteDatabase(r'C:\myproject\data.db')（Windows）或SqliteDatabase('/home/user/myproject/data.db')（Linux/macOS） - 更稳妥的做法是用
pathlib.Path拼接：db = SqliteDatabase(Path(__file__).parent / 'data.db') - SQLite文件被占用时（比如另一个Python进程正连着它），
db.connect()会卡住或抛DatabaseError，此时需检查是否有未关闭的db.close()或未提交的事务
真正容易被忽略的是：Peewee的Model.create_tables()不会覆盖已有表，也不会自动同步字段变更。改了Model类之后，必须手动用playhouse.migrate做迁移，否则新增字段永远写不进去——这不是VS Code的问题，但新手常误以为是配置失败。
