在需要有关使用 Neon 无服务器 Postgres 的指南和最佳实践时使用此技能。涵盖设置、连接方法、分支、自动扩展、零扩展、只读副本、连接池、Neon Auth，以及 Neon CLI、MCP 服务器、REST API、TypeScript SDK 和 Python SDK。当用户询问相关内容时使用。

指导用户完成任何与 Neon 相关的任务：设置、连接、分支和高级功能。提供一个可用的 Neon 连接、一个完整的功能配置，或来自官方 Neon 文档的具体答案。

Neon 是一个无服务器的 Postgres 平台，它将计算和存储分离，以提供自动扩展、分支、即时恢复和零规模扩展功能。它完全兼容 Postgres，并且可以与支持 Postgres 的任何语言、框架或 ORM 一起使用。

Neon 文档是所有与 Neon 相关信息的权威来源。在回应之前，请始终根据官方文档核实信息。Neon 的功能和 API 会不断变化，因此应优先获取最新文档，而不是依赖训练数据。

任何 Neon 文档页面都可以通过两种方式以 Markdown 格式获取：

两者返回相同的 Markdown 内容。使用你的工具支持的任何一种方法。

文档索引列出每个可用页面及其 URL 和简短描述：

常见的文档 URL 被整理在下面的主题链接中。如果你需要未列出的页面，请搜索文档索引：https://neon.com/docs/llms.txt。不要猜测 URL。

在提供实现建议之前，先用它来解释架构和术语（组织、项目、分支、端点）。

链接: https://neon.com/docs/introduction/architecture-overview.md

在引导用户首次设置 Neon 时使用本节。

在开始设置之前，检查用户的代码库和环境：

使用 Neon 的 CLI 或 MCP 服务器进行自动驾驶设置

提供检查现有已连接的 Neon 项目或使用 Neon CLI 或 MCP 服务器创建新项目。如果尚未设置任何项目，请使用 --agent 标志运行 init。使用 npx -y 可跳过安装包提示。认证将自动处理。如果用户未登录，它会打开浏览器进行 OAuth，并在完成后再继续。

npx -y neon@latest init --agent <agent-name>

支持的 --agent 值：cursor、copilot、claude、claude-desktop、codex、opencode、cline、gemini-cli、goose、zed。

这会安装 Neon 扩展（用于 Cursor/VS Code）或 MCP 服务器（用于其他代理），创建一个 API 密钥，并将 neon-postgres 代理技能添加到项目中。

如果 init 不适用，可以以非交互方式运行各个步骤：

有关完整的 CLI 安装选项，请参见 https://neon.com/docs/reference/cli-install.md

使用 MCP 服务器或命令行界面列出组织和项目。让用户选择现有项目或创建新项目。

使用 MCP 服务器或 CLI 获取连接字符串。将其存储在 .env 中，作为 DATABASE_URL。在修改之前先读取文件，以避免覆盖现有值。

请参阅连接方式指南，根据部署平台选择正确的驱动程序：https://neon.com/docs/connect/choose-connection.md

4. 使用 Neon Auth 进行用户认证（如有需要）

跳过 CLI 工具、脚本或没有用户账户的应用程序。如果应用程序需要身份验证：使用 MCP 服务器的 provision_neon_auth 工具，然后查看身份验证概述（https://neon.com/docs/auth/overview.md）以进行设置。有关身份验证数据库查询，请参阅 JavaScript SDK 参考（https://neon.com/docs/reference/javascript-sdk.md）。

检查是否存在现有的 ORM（Prisma、Drizzle、TypeORM）。如果没有，询问他们是否需要一个。有关 Drizzle 集成，请参见 https://neon.com/docs/guides/drizzle.md。

如果恢复设置，请检查已配置的内容（MCP 连接、带有 DATABASE_URL 的 .env、依赖项、模式），并从下一个未完成的步骤继续。

提醒用户使用环境变量来存储凭据，切勿提交连接字符串，并使用最小权限的数据库角色。

当你需要根据运行时约束（TCP、HTTP、WebSocket、边缘、无服务器、长时间运行）选择正确的传输和驱动程序时使用此工具。

链接: https://neon.com/docs/connect/choose-connection.md

推荐：Drizzle 是适合您运行时的正确驱动程序

总是将 Neon 与 Drizzle 等 ORM 配合使用，以便轻松管理模式和迁移。根据运行时如何处理你的代码选择驱动程序：

Neon 功能 / Vercel / 流体计算 — Drizzle node-postgres:

import { drizzle } from "drizzle-orm/node-postgres";
import { Pool } from "pg";
import * as schema from "./schema";

// Created once at module scope; reused by every request the instance handles.
const pool = new Pool({ connectionString: process.env.DATABASE_URL, max: 5 });
const db = drizzle({ client: pool, schema });

在 Vercel（Fluid compute）上，也使用 @vercel/functions 的 attachDatabasePool 附加连接池，这样函数运行时会在实例挂起之前清理空闲连接：

import { drizzle } from "drizzle-orm/node-postgres";
import { Pool } from "pg";
import { attachDatabasePool } from "@vercel/functions";
import * as schema from "./schema";

const pool = new Pool({ connectionString: process.env.DATABASE_URL });
attachDatabasePool(pool); // let the Vercel runtime manage the pooled connections
const db = drizzle({ client: pool, schema });

Netlify 和其他完全隔离的无服务器 — Drizzle Neon 无服务器驱动：

import { drizzle } from "drizzle-orm/neon-http";
import { neon } from "@neondatabase/serverless";

const sql = neon(process.env.DATABASE_URL!);
const db = drizzle({ client: sql });

将此用于 @neondatabase/serverless 模式，包括 HTTP 查询、WebSocket 事务和特定运行时优化。

链接: https://neon.com/docs/serverless/serverless-driver.md

将此用于结合 Neon Auth 数据 API 工作流的 PostgREST 风格查询和类型化客户端设置。

链接: https://neon.com/docs/reference/javascript-sdk.md

使用此命令进行本地开发启用：npx -y neon@latest init --agent ，用于 VSCode 扩展设置以及 Neon MCP 服务器配置。

CLI Init Command https://neon.com/docs/reference/cli-init.md

VSCode Extension https://neon.com/docs/local/vscode-extension.md

MCP Server https://neon.com/docs/ai/neon-mcp-server.md

Neon CLI https://neon.com/docs/reference/neon-cli.md

将此用于以终端为先的工作流程、脚本和使用 neon 的 CI/CD 自动化。

链接: https://neon.com/docs/reference/neon-cli.md

Neon 管理 API 可用于以编程方式管理 Neon 资源。它在幕后被 Neon CLI 和 MCP 服务器使用，但也可以直接使用，以实现更复杂的自动化工作流程，或在将 Neon 嵌入其他应用程序时使用。

用于直接的 HTTP 自动化、端点级控制、API 密钥认证、速率限制处理和操作轮询。

链接: https://neon.com/docs/reference/api-reference.md

在通过 @neondatabase/api-client 在 TypeScript 中实现 Neon 资源的类型化编程控制时使用此方法。

链接: https://neon.com/docs/reference/typescript-sdk.md

在使用 neon-api 包在 Python 中实现程序化 Neon 管理时使用此方法。

链接: https://neon.com/docs/reference/python-sdk.md

在 Next.js 和 React 应用中，将此用于托管用户身份验证设置、UI 组件、身份验证方法以及 Neon Auth 集成陷阱。

链接: https://neon.com/docs/auth/overview.md

Neon Auth 也嵌入在 Neon JS SDK 中。根据您的使用情况，您可能希望使用 Neon JS SDK 而不是单独使用 Neon Auth。更多详情请参阅 https://neon.com/docs/connect/choose-connection.md。

neon.ts 是 Neon 的分支配置和基础设施即代码文件：声明你的分支有哪些服务，获取类型安全的环境变量，并为每个分支编写计算逻辑 —— 所有这些都使用 TypeScript（完整参考请参见 neon 技能）。Postgres 总是在每个分支上存在，因此你无需声明数据库本身；你在这里编码的是与 Postgres 相关的表面功能 —— Neon 身份认证、数据 API 以及每个分支的计算设置（自动扩缩和归零缩放）。

// neon.ts
import { defineConfig } from "@neon/config/v1";

export default defineConfig({
  auth: true, // Neon Auth (adds NEON_AUTH_* env vars)
  dataApi: true, // Data API (adds NEON_DATA_API_URL); requires auth: true (or an external IdP)
  // Postgres exists on every branch; tune its compute per branch:
  branch: (branch) => {
    if (branch.exists) return {}; // leave existing branches untouched
    if (branch.isDefault) return { protected: true }; // prod keeps default compute
    return {
      ttl: "7d", // non-prod branches auto-expire (max 30d)
      postgres: {
        computeSettings: {
          autoscalingLimitMinCu: 0.25, // scale to zero
          autoscalingLimitMaxCu: 1, // keep dev/preview cheap
          suspendTimeout: "5m",
        },
      },
    };
  },
});

从 CLI 对声明进行调和 — 相当于 Neon 的 terraform plan / apply：

Neon Postgres 实用指南

Guides and best practices for working with Neon Serverless Postgres. Covers setup, connection methods, branching, autoscaling, scale-to-zero, read replicas, connection pooling, Neon Auth, and the Neon CLI, MCP server, REST API, TypeScript SDK, and Python SDK. Use when users ask about...

数据库

云计算

后端

Neon无服务器Postgres实用指南：涵盖设置、连接、分支、自动扩展、只读副本及连接池等核心功能，提供CLI、MCP服务器及TypeScript/Python SDK操作指引，附官方文档Markdown获取方法与安全提醒，助力开发者快速上手。

基础设施即代码

身份验证

自动驾驶

软件开发

JavaScript

TypeScript 

服务器

Python

OAuth

Agent

CIDR

腾讯云大数据特惠0.2折起


oceanus

2026上云采购 | AI焕新·智启新局

cclid

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Neon Postgres 实用指南

Neon Postgres 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐