如何在 Python 中使用 SQLite 创建并操作数据库文件

发布时间 - 2025-12-29 00:00:00    点击率:

本文详解如何用 python 的 sqlite3 模块创建数据库文件、执行查询与更新操作,并重点指出 `conn.commit()` 是持久化写入操作的关键步骤,否则 insert/update/delete 将不会真正保存到磁盘。

在 Python 中使用 SQLite 创建数据库文件极其简单——只需调用 sqlite3.connect('filename.db'),若该文件不存在,SQLite 会自动创建;若存在,则直接连接。但真正容易被忽略、导致“更新不生效”的核心问题是:所有修改数据库状态的操作(如 INSERT、UPDATE、DELETE)都必须显式调用 conn.commit() 才能将变更写入磁盘。未提交的事务在连接关闭后会被自动回滚,这也是原代码中 updateDB 方法看似执行成功却无实际效果的根本原因。

以下是一个精简、健壮且可复用的数据库操作类示例:

import sqlite3

class DatabaseConnector:
    def __init__(self, db_name="app.db"):
        self.db_name = db_name

    def connect(self):
        try:
            return sqlite3.connect(self.db_name)
        except sqlite3.Error as e:
            print(f"数据库连接失败: {e}")
            return None

    def disconnect(self, conn):
        if conn:
            conn.close()

    def queryDB(self, command, params=()):
        """执行 SELECT 查询,返回结果列表"""
        conn = self.connect()
        if not conn:
            return []
        try:
            cur = conn.cursor()
            cur.execute(command, params)
            result = cur.fetchall()
            return result
        except sqlite3.Error as e:
            print(f"查询出错: {e}")
            return []
        finally:
            self.disconnect(conn)

    def updateDB(self, command, params=()):
        """执行 INSERT/UPDATE/DELETE 等写操作,返回受影响行数"""
        conn = self.connect()
        if not conn:
            return 0
        try:
            cur = conn.cursor()
            cur.execute(command, params)
            conn.commit()  # ✅ 关键:必须提交事务!
            return cur.rowcount  # 返回影响的行数,便于调试与验证
        except sqlite3.Error as e:
            print(f"更新出错: {e}")
            conn.rollback()  # 出错时主动回滚,避免脏状态
            return 0
        finally:
            self.disconnect(conn)

使用示例:

db = DatabaseConnector("BUYHIRELtd.db")

# 创建表(首次运行将生成 .db 文件)
db.updateDB("""
    CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY,
        name TEXT NOT NULL,
        email TEXT UNIQUE
    )
""")

# 插入数据
rows = db.updateDB("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice", "alice@buyhire.com"))
print(f"插入了 {rows} 行")  # 输出:插入了 1 行

# 查询验证
users = db.queryDB("SELECT * FROM users WHERE name = ?", ("Alice",))
print(users)  # 输出:[(1, 'Alice', 'alice@buyhire.com')]

⚠️ 注意事项与最佳实践:

  • 不要在 updateDB 中调用 cur.fetchall() —— 写操作通常无结果集,fetchall() 返回空列表且可能掩盖逻辑错误;应改用 cur.rowcount 获取影响行数;
  • 始终在 try...except...finally 或上下文管理器中处理连接,确保异常时也能安全断开;
  • 生产环境建议使用 with sqlite3.connect(...) as conn: 自动管理连接生命周期;
  • 避免字符串拼接 SQL(防 SQL 注入),始终使用参数化查询(? 占位符 + params 元组);
  • .db 文件默认生成在脚本当前工作目录,可通过 os.path.abspath(self.db_name) 明确路径定位。

掌握 connect → execute → commit → close 这一闭环流程,即可稳定、可靠地在 Python 中创建和维护 SQLite 数据库文件。


# python  # app  # ai 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel模型关联查询教程_Laravel Eloquent一对多关联写法  如何在IIS7上新建站点并设置安全权限?  Laravel如何生成API文档?(Swagger/OpenAPI教程)  Laravel怎么在Blade中安全地输出原始HTML内容  HTML透明颜色代码在Angular里怎么设置_Angular透明颜色使用指南【详解】  Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】  如何在浏览器中启用Flash_2025年继续使用Flash Player的方法【过时】  Laravel队列任务超时怎么办_Laravel Queue Timeout设置详解  如何在腾讯云服务器上快速搭建个人网站?  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  Laravel如何使用Facades(门面)及其工作原理_Laravel门面模式与底层机制  如何在阿里云通过域名搭建网站?  如何将凡科建站内容保存为本地文件?  Laravel如何实现用户注册和登录?(Auth脚手架指南)  网站制作企业,网站的banner和导航栏是指什么?  EditPlus中的正则表达式 实战(2)  高端智能建站公司优选:品牌定制与SEO优化一站式服务  绝密ChatGPT指令:手把手教你生成HR无法拒绝的求职信  如何在IIS中新建站点并解决端口绑定冲突?  Laravel API资源类怎么用_Laravel API Resource数据转换  Win11怎么更改系统语言为中文_Windows11安装语言包并设为显示语言  阿里云高弹*务器配置方案|支持分布式架构与多节点部署  香港服务器建站指南:免备案优势与SEO优化技巧全解析  Laravel PHP版本要求一览_Laravel各版本环境要求对照  Android Socket接口实现即时通讯实例代码  邀请函制作网站有哪些,有没有做年会邀请函的网站啊?在线制作,模板很多的那种?  制作电商网页,电商供应链怎么做?  Laravel如何集成第三方登录_Laravel Socialite实现微信QQ微博登录  Python文本处理实践_日志清洗解析【指导】  如何在 Go 中优雅地映射具有动态字段的 JSON 对象到结构体  如何有效防御Web建站篡改攻击?  微信小程序 require机制详解及实例代码  Laravel如何配置任务调度?(Cron Job示例)  EditPlus中的正则表达式 实战(1)  Android 常见的图片加载框架详细介绍  微博html5版本怎么弄发语音微博_语音录制入口及时长限制操作【教程】  如何用PHP快速搭建CMS系统?  今日头条微视频如何找选题 今日头条微视频找选题技巧【指南】  Laravel如何实现用户密码重置功能?(完整流程代码)  laravel怎么为API路由添加签名中间件保护_laravel API路由签名中间件保护方法  Claude怎样写结构化提示词_Claude结构化提示词写法【教程】  Laravel如何使用Service Provider服务提供者_Laravel依赖注入与容器绑定【深度】  网站制作软件有哪些,制图软件有哪些?  如何在香港服务器上快速搭建免备案网站?  Laravel用户密码怎么加密_Laravel Hash门面使用教程  laravel怎么为应用开启和关闭维护模式_laravel应用维护模式开启与关闭方法  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  佛山网站制作系统,佛山企业变更地址网上办理步骤?  米侠浏览器网页图片不显示怎么办 米侠图片加载修复  DeepSeek是免费使用的吗 DeepSeek收费模式与Pro版本功能详解