[ PROMPT_NODE_23570 ]
getting-started
[ SKILL_DOCUMENTATION ]
# Neon 入门
交互式指南,帮助用户在项目中开始使用 Neon。设置他们的 Neon 项目(包含连接字符串)并将数据库连接到代码。
获取官方入门指南:
bash
curl -H "Accept: text/markdown" https://neon.tech/docs/get-started/signing-up
## 交互式设置流程
### 第 1 步:检查组织和项目
**首先,检查组织:**
- 如果有 1 个组织:默认为该组织
- 如果有多个组织:列出所有组织并询问使用哪一个
**然后,检查所选组织内的项目:**
- **无项目**:询问是否要创建新项目
- **1 个项目**:询问“您想使用 '{project_name}' 还是创建一个新项目?”
- **多个项目 (<6)**:列出所有项目并让他们选择
- **许多项目 (6+)**:列出最近的项目,提供创建新项目或按名称/ID 指定的选项
### 第 2 步:数据库设置
**获取连接字符串:**
- 使用 MCP 服务器获取所选项目的连接字符串
**为他们的环境进行配置:**
- 大多数项目使用带有 `DATABASE_URL` 的 `.env` 文件
- 对于其他设置,检查项目结构并询问
**修改 .env 之前:**
1. 首先尝试读取 .env 文件
2. 如果可读:使用 search_replace 进行更新或追加
3. 如果不可读:使用追加命令或显示需要手动添加的行:
DATABASE_URL=postgresql://user:password@host/database
### 第 3 步:安装依赖
根据部署平台和运行时推荐驱动程序。有关详细指导,请参阅 `connection-methods.md`。
**快速推荐:**
| 环境 | 驱动程序 | 安装 |
| ------------------------ | -------------------------- | -------------------------------------- |
| Vercel (Edge/Serverless) | `@neondatabase/serverless` | `npm install @neondatabase/serverless` |
| Cloudflare Workers | `@neondatabase/serverless` | `npm install @neondatabase/serverless` |
| AWS Lambda | `@neondatabase/serverless` | `npm install @neondatabase/serverless` |
| 传统 Node.js | `pg` | `npm install pg` |
| 长时间运行的服务器 | `pg` (带连接池) | `npm install pg` |
有关详细的无服务器驱动程序使用,请参阅 `neon-serverless.md`。
对于复杂场景(多个运行时、混合架构),请参考 `connection-methods.md`