`better-sqlite3` 教程

1. 项目目录结构及介绍

better-sqlite3 是一个用于 Node.js 的高效 SQLite3 库。其主要的目录结构如下：

better-sqlite3/
├── lib/             # 包含库的核心功能实现
├── test/            # 测试用例
├── examples/        # 示例代码
├── docs/            # 文档源码
│   ├── api.md       # API 文档
├── .gitignore       # Git 忽略规则
└── package.json     # 项目元数据，包括依赖和脚本

其中，lib 目录包含了与 SQLite3 交互的主要 JavaScript 和 C++ 模块，test 目录存储了单元测试，examples 提供了一些简单示例，而 docs/api.md 是 API 文档的 Markdown 文件。

2. 项目启动文件介绍

在 Node.js 中，better-sqlite3 通常通过 require() 调用来导入并使用。没有特定的启动文件，因为这个库是作为一个模块被其他项目引入的。例如，你可以创建一个新的 .js 文件，然后按下面的方式导入和使用它：

const sqlite3 = require('better-sqlite3');

// 创建或打开数据库连接
const db = new sqlite3.Database('example.db');

上面的代码展示了如何创建一个新的数据库实例，该实例可以用于执行 SQL 查询和操作。

3. 项目配置文件介绍

better-sqlite3 不直接使用配置文件，而是通过构造函数的选项来配置数据库连接。这些选项可以直接传递给 Database 构造函数，例如：

const db = new sqlite3.Database('database.db', {
  // 配置选项
  readonly: true,
  timeout: 10000,
  verbose: (sql) => console.log(sql),
});

• readonly: 是否以只读模式打开数据库，默认为 false。
• timeout: 当查询锁定时等待的毫秒数，超过此时间会抛出 SQLITE_BUSY 错误，默认为 5000。
• verbose: 可选的日志回调，用于打印执行的 SQL 语句。

此外，还可以加载 SQLite3 扩展或自定义配置，但这是通过 loadExtension 方法完成的，不是通过配置文件。

为了适应不同场景的需求，有时需要在应用级别或者初始化阶段进行更复杂的设置。这种情况下，可以考虑在你的应用中创建一个配置对象，然后将这个对象作为参数传递给 Database 构造函数。

以上就是对 better-sqlite3 项目的基本介绍。通过理解和运用这些概念，你应该能够轻松地开始使用这个库与 SQLite3 数据库进行交互。