跨Windows/Linux开发Flask应用：SQLAlchemy SQLite数据库URI配置方案

核心结论 #

优先采用Flask内置的app.instance_path结合pathlib处理路径，这是官方推荐的规范方案，既能保证路径可靠性，又能完美适配Windows和Linux系统。

问题原因 #

你遇到的Windows报错，本质是手动拼接URI时，反斜杠\未被正确处理——SQLite的URI格式要求路径用正斜杠，或反斜杠转义，直接拼接的字符串无法满足这个要求。

正确实现方式 #

方法1：用pathlib（推荐，Python3.4+内置） #

pathlib自动适配跨平台路径分隔符，生成的路径可直接被SQLAlchemy识别：

from pathlib import Path
from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
# 拼接instance目录下的数据库文件路径
db_file = Path(app.instance_path) / "test.db"
# 生成符合要求的URI
app.config["SQLALCHEMY_DATABASE_URI"] = f"sqlite:///{db_file.resolve()}"
db = SQLAlchemy(app)

resolve()确保生成绝对路径，避免工作目录变化带来的问题；部分SQLAlchemy版本支持直接传入Path对象，写法更简洁：

app.config["SQLALCHEMY_DATABASE_URI"] = f"sqlite:///{db_file}"

方法2：手动转换路径分隔符 #

如果不想用pathlib，可以将Windows的反斜杠替换为正斜杠，SQLite能正常识别正斜杠路径：

import os
from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
db_path = os.path.join(app.instance_path, "test.db")
# 替换反斜杠为正斜杠
db_path = db_path.replace("\\", "/")
app.config["SQLALCHEMY_DATABASE_URI"] = f"sqlite:///{db_path}"
db = SQLAlchemy(app)

关于相对路径的取舍 #

你目前用的相对路径sqlite:///../instance/test.db虽然能跨平台运行，但存在隐患：它依赖当前工作目录，如果从不同目录启动Flask应用（比如在项目根目录和子目录分别执行flask run），会导致路径解析错误。而app.instance_path是Flask根据应用根目录生成的固定路径，不受启动目录影响，可靠性更高。

验证效果 #

用上述方案生成的URI在双系统下均能被正确解析：

• Windows：sqlite:///C:/Users/user/test-app/instance/test.db（正斜杠格式，SQLite可识别）
• Linux：sqlite:////home/user/test-app/instance/test.db（符合Linux URI规范）

内容的提问来源于stack exchange，提问作者oscarale