Turso基础入门：安装配置与数据库创建
(2) feilong.org 修订于2026-06-25 16:04:01 Turso教程Turso简介与核心优势
Turso 是一个基于云原生架构的 SQLite 数据库服务，结合了 SQLite 的轻量级特性与云数据库的弹性扩展能力。其设计目标是为开发者提供低代码、高可用性且成本可控的数据库解决方案。本文将引导您完成 Turso 的安装配置流程，并演示如何创建和管理数据库实例。
---
安装Turso CLI工具
Turso 提供命令行接口（CLI）用于本地开发与云资源管理。以下是跨平台安装步骤：
1. 使用 curl 安装（推荐）
运行以下命令下载并安装 Turso CLI：
|
1 |
curl -L https://turso.sh/install | bash |
该脚本会自动将 turso 命令添加到系统路径中。
2. 验证安装
执行以下命令检查版本信息：
|
1 |
turso --version |
输出示例：
|
1 |
turso 0.15.4 |
---
配置Turso环境
安装完成后，需通过 CLI 初始化本地配置文件。
1. 创建配置文件
运行以下命令生成默认配置：
|
1 |
turso config init |
该操作会在当前目录下创建
|
1 |
.turso/config |
文件，用于存储 API 密钥等敏感信息。
2. 设置 API 密钥
通过以下命令登录 Turso 控制台并获取 API 密钥：
|
1 |
turso login |
系统会引导您输入控制台的访问令牌（Access Token）。此密钥将用于后续操作的身份验证。
---
创建数据库实例
Turso 支持本地开发与云部署两种模式，以下演示如何创建云数据库实例。
1. 初始化数据库项目
运行以下命令创建新数据库：
|
1 |
turso db create my-first-db |
此操作会生成一个名为
|
1 |
my-first-db |
的数据库实例，并自动完成基础配置。
2. 验证数据库状态
使用以下命令查看数据库状态及连接信息：
|
1 |
turso db info my-first-db |
输出示例：
|
1 2 3 4 |
NAME : my-first-db STATUS : running URL : sqlite:///my-first-db.sqlite REMOTE_URL : https://my-first-db.turso.io |
---
连接与操作数据库
Turso 提供本地 SQLite 文件与云数据库的双向连接能力。
1. 使用 SQLite 工具访问本地文件
通过 sqlite3 命令行工具操作本地数据库文件：
|
1 |
sqlite3 ./my-first-db.sqlite |
执行 SQL 查询示例：
|
1 2 3 |
CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT); INSERT INTO users (name) VALUES ('Alice'); SELECT * FROM users; |
2. 连接云数据库
使用
|
1 |
turso connect |
命令获取远程连接字符串：
|
1 |
turso connect my-first-db |
输出的 URL 可用于应用程序配置，例如：
|
1 2 3 4 5 |
import sqlite3 conn = sqlite3.connect('https://my-first-db.turso.io') cursor = conn.cursor() cursor.execute("SELECT * FROM users") print(cursor.fetchall()) |
---
常见问题与注意事项
1. API 密钥安全：避免在公共代码仓库中暴露
|
1 |
.turso/config |
文件。
2. 本地文件同步：Turso 会自动将本地 SQLite 文件变更推送到云实例，但需确保网络连接稳定。
3. 版本兼容性：CLI 工具与数据库引擎版本需保持一致以避免兼容性问题。
---
结语
通过本文的步骤，您已掌握 Turso 的基础安装、配置及数据库创建流程。Turso 的轻量级设计使其成为本地开发与云部署的理想选择，其无缝集成能力可显著降低数据库管理复杂度。后续可进一步探索 Turso 的备份恢复、监控告警等高级功能。
更新网址：https://feilong.org/turso-getting-started
最初发布：20260625 04:04:01 feilong.org 于广州
加入收藏夹，查看更方便。