用途:为在 Netlify 上部署和配置各类 Web 框架提供指引,涵盖构建设置、SSR/边缘适配器、本地平台模拟与环境变量。框架专属细节见 references/astro.md、nextjs.md、nuxt.md、sveltekit.md、tanstack.md、vite.md。
主要能力:给出各框架的构建命令与发布目录(如 Astro astro build/dist、Next.js next build/.next、SvelteKit vite build/build、Nuxt 3 nuxt build/dist、Vite vite build/dist 等),并说明 SSR/适配器接入方式。Astro 用 npx astro add netlify;Next.js 13.5+ 通过 OpenNext 适配器零配置,勿固定版本;SvelteKit 安装 @sveltejs/adapter-netlify 并替换 adapter-auto;React Router 7+ 用 @netlify/vite-plugin-react-router;Remix 用 @netlify/remix-adapter;Nuxt 3 SSR 经 Nitro 自动,本地用 @netlify/nuxt;SolidStart 2 用 @netlify/vite-plugin;TanStack Start 用 @netlify/vite-plugin-tanstack-start;Gatsby 5.12+ 自动装 gatsby-adapter-netlify;Angular SSR 经 Edge Function;Express 经 serverless-http 部署为函数;Hydrogen 仅支持 Edge Functions。
使用方式:Vite 系框架可在开发服务器内模拟 Netlify 原语(函数、边缘函数、blobs、数据库、缓存、图片 CDN、重定向、环境变量、AI Gateway);Gatsby 生成函数、Angular SSR 本地测试等仍需 netlify dev。CLI 部署用 npm install netlify-cli -g 后 netlify init。
限制与注意:环境变量在构建时注入,任何改动都需重新部署;客户端前缀(VITE_、NEXT_PUBLIC_、PUBLIC_、NUXT_PUBLIC_、REACT_APP_、GATSBY_、VUE_APP_)会内联进浏览器包,不可用于密钥;netlify.toml 仅构建期读取,运行时变量需在 UI/CLI/API 设置。采用 SSR 适配器时须移除 SPA 通配重定向 /* /index.html 200。SvelteKit 的 split 与 edge 互斥,重定向需用 _redirects。Next.js 偏斜保护为可选且受版本条件限制。部分框架版本、平台支持与本地模拟范围以官方资料为准,未提供的信息暂未说明。