用途:把前端或静态项目部署到 Netlify,通常由 vibe-coding-ship 在目标平台为 Netlify 时调用。
主要能力:创建或关联站点、连接 Git、按框架设置构建命令与发布目录、管理环境变量、配置重定向与域名,并输出部署结果。
使用方式:先判断项目类型。若是 Flask/Django/FastAPI 等需要常驻进程的 Python 全栈应用,应停止并改用 Railway、Render、Fly.io 或 DigitalOcean App Platform,Netlify 仅支持 netlify/functions/*.py 形式的无服务器函数。若环境变量存在 NETLIFY_AUTH_TOKEN,走令牌模式;否则走交互模式。
交互模式:netlify --version 检查 CLI,缺失时 npm install -g netlify-cli;netlify login 登录;cat .netlify/state.json 检查是否已关联;netlify init 或 netlify link 初始化或关联。构建设置示例:Next.js 用 next build、发布 .next 并安装 @netlify/plugin-nextjs;Vite 用 npm run build、发布 dist;CRA 用 npm run build、发布 build。部署用 netlify deploy 生成草稿 URL,netlify deploy --prod 发布生产,生产部署前需用户确认。
令牌模式:export NETLIFY_AUTH_TOKEN 与 NETLIFY_SITE_ID 后,执行 netlify deploy --auth=$NETLIFY_AUTH_TOKEN --site=$NETLIFY_SITE_ID,加 --prod 发布生产。
环境变量:netlify env:list、netlify env:set、netlify env:import .env.production、netlify env:unset。
netlify.toml 可配置 [build] 的 command 与 publish、[build.environment] 的 NODE_VERSION、[[redirects]] 的 SPA 回退与 API 代理、[[plugins]] 的 Next.js 插件。
常见问题:next 命令找不到时把 next 从 devDependencies 移到 dependencies;React Router v6 嵌套路由的 SPA 重定向需确保 /* 规则位于 netlify.toml 最后,或用发布根目录的 _redirects 文件;函数未部署需检查 netlify/functions/ 与导出 handler;构建时缺少环境变量可先 netlify env:list 再用 netlify deploy --build。
域名:netlify domains:add yourdomain.com、netlify dns:list。
限制:不支持持久化 Python 服务器、长运行进程与后台 worker;生产部署需确认;具体收费与配额资料未提供。