app.py中SQLite数据库相对路径失效，如何适配团队协作？

问题根源在于：Python的相对路径是基于运行脚本时的当前工作目录解析的，而非脚本文件本身所在的目录。比如你在model/目录下运行脚本时，当前工作目录是model/，../databases/database.db能正确定位到项目根目录下的数据库；但如果在项目根目录运行app.py，当前工作目录是根目录，再用../会向上跳出项目目录，自然找不到文件。

以下是几种可靠的解决方法：

方法1：基于脚本自身目录构建路径（推荐） #

不管脚本在哪运行，都以脚本文件的绝对位置为基准拼接数据库路径，确保路径逻辑一致。

假设你的项目结构是：

your_project/
├── app.py
├── databases/
│   └── database.db
└── model/
    └── model_script.py

model/model_script.py中的代码：

import os
import sqlite3

# 获取当前脚本的绝对目录
script_dir = os.path.dirname(os.path.abspath(__file__))
# 从model目录向上一级，拼接数据库路径
db_path = os.path.join(script_dir, "../databases/database.db")
# 标准化路径，消除../这类相对符号
db_path = os.path.normpath(db_path)

# 连接数据库
conn = sqlite3.connect(db_path)

app.py中的代码：

import os
import sqlite3

# 获取app.py所在的项目根目录
script_dir = os.path.dirname(os.path.abspath(__file__))
# 直接从根目录拼接数据库路径
db_path = os.path.join(script_dir, "databases/database.db")
db_path = os.path.normpath(db_path)

conn = sqlite3.connect(db_path)

方法2：统一以项目根目录为基准 #

通过约定的项目标识（比如根目录下的databases文件夹）自动定位项目根目录，所有脚本都基于根目录拼接路径，无需关心自身位置。

通用代码（可在所有脚本中复用）：

import os
import sqlite3

def get_project_root():
    current_dir = os.path.dirname(os.path.abspath(__file__))
    # 循环向上查找，直到找到包含databases文件夹的目录
    while not os.path.exists(os.path.join(current_dir, "databases")):
        current_dir = os.path.dirname(current_dir)
        # 防止无限循环，到达系统根目录仍未找到则抛出错误
        if current_dir == os.path.dirname(current_dir):
            raise FileNotFoundError("无法定位项目根目录：未找到databases文件夹")
    return current_dir

# 获取项目根目录并拼接数据库路径
project_root = get_project_root()
db_path = os.path.join(project_root, "databases/database.db")

conn = sqlite3.connect(db_path)

方法3：使用环境变量（适配团队协作） #

团队成员通过环境变量指定数据库路径，脚本读取环境变量连接，避免硬编码路径。

代码示例：

import os
import sqlite3

# 优先读取环境变量中的数据库路径
db_path = os.getenv("PROJECT_DB_PATH")

# 如果环境变量未设置， fallback到基于脚本目录的路径
if not db_path:
    script_dir = os.path.dirname(os.path.abspath(__file__))
    # 根据脚本位置调整相对路径，这里以model目录下的脚本为例
    db_path = os.path.join(script_dir, "../databases/database.db")
    db_path = os.path.normpath(db_path)

conn = sqlite3.connect(db_path)

团队成员可通过终端设置环境变量：

• Linux/macOS：export PROJECT_DB_PATH="/your/project/path/databases/database.db"
• Windows：set PROJECT_DB_PATH=C:\your\project\path\databases\database.db

也可以用.env文件配合python-dotenv库管理环境变量，方便团队统一配置。

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