# 快速开始

URL: https://caijiao.org/lowdb/01-introduction/02-quick-start
Source: docs/lowdb/01-introduction/02-quick-start.md
Description: 本指南介绍了如何快速开始使用 LowDB。包括通过 npm 安装 LowDB 包，以及如何初始化数据库、定义适配器、读取数据和写入数据等基本操作，帮助您在几分钟内搭建起本地数据存储。

## 安装

```bash
npm install lowdb
```

## 基本使用

```javascript
import { Low, JSONFile } from 'lowdb'

const adapter = new JSONFile('db.json')
const db = new Low(adapter)

await db.read()
db.data ||= { posts: [] }

db.data.posts.push({ id: 1, title: 'lowdb is awesome' })
await db.write()
```