>
← 返回投肯智能知识库首页
首页 / 技术教程 / 工具推荐

Bolt.new + AI 编程入门完全指南:从浏览器到可运行项目

📖 阅读时长:45分钟更新:2026-05-27

一、背景:为什么传统开发环境让人头疼

1.1 传统前端开发的环境之痛

每一位前端开发者都曾经历过这样的场景:入职新项目后,README 文档写着"Node.js 16+,npm 8+,确保全局安装了 vue-cli",然后你花了整整一下午,卸载重装了三个版本的 Node,才勉强把项目跑起来。这不是个例,而是整个前端生态的集体困扰。

传统前端开发的环境搭建通常面临以下几个核心痛点:

1.2 Bolt.new 是什么

Bolt.new 是 StackBlitz 在 2024 年推出的基于浏览器的 AI 编程环境。它将大型语言模型(LLM)的代码生成能力与云端隔离的开发环境结合在一起,让你可以在浏览器中完成从项目创建、功能开发到调试部署的全部工作。

StackBlitz 本身是一个知名的在线代码编辑器,支持 WebContainer 技术(基于浏览器的 Node.js 运行时),无需在本地安装任何环境即可运行前端项目。Bolt.new 在此基础上集成了 AI 对话能力,可以根据自然语言描述自动生成代码、创建文件、修复错误。

1.3 传统开发 vs Bolt.new 核心对比

下表从关键维度对比传统本地开发与 Bolt.new 的差异:

对比维度传统本地开发Bolt.new
环境准备时间30分钟 ~ 数小时(安装依赖、解决冲突)0分钟,直接打开浏览器即可
Node.js 版本管理需要 nvm/nvs 等工具手动切换云端自动配置,无需管理
依赖安装本地下载,速度受网络影响WebContainer 流式加载,首次安装即可交互
项目创建手动执行 create-vite / create-react-appAI 对话描述需求,自动生成完整项目结构
跨设备协作需要代码仓库 + 同步工具URL 直接分享,对方打开即可看到完全相同的环境
调试体验终端 + 浏览器 DevTools终端 + 浏览器 DevTools + AI 辅助修复
部署发布需要手动配置 Vercel / Netlify / 服务器内置一键部署到生产环境
离线能力完全可用需要网络连接
核心区别:Bolt.new 将"环境配置"这个纯消耗性工作完全剥离,让开发者专注于"做什么"而非"怎么配置"。AI 在这个过程中扮演的角色不只是辅助编码,而是替代了大量需要手动操作的工程化工作。

二、方案:Bolt.new 完整使用步骤

2.1 注册与登录

Bolt.new 托管在 StackBlitz 平台上,目前访问地址为 bolt.new。以下是具体注册步骤:

  1. 打开浏览器,访问 https://bolt.new
  2. 页面会引导你使用 GitHub 账号授权登录(这是目前唯一的登录方式,点击"Continue with GitHub"按钮)
  3. 在弹出的 OAuth 授权页面点击"Authorize"确认授权
  4. 授权成功后,页面会跳转到 Bolt.new 的工作界面,首次使用会看到简短的功能介绍弹窗,点击"Skip"关闭即可
注意:Bolt.new 依赖 GitHub 账号体系。如果你没有 GitHub 账号,需要先前往 github.com 注册一个账号。GitHub 免费账号即可使用 Bolt.new 的基础功能。

2.2 创建第一个项目

Bolt.new 提供了两种创建项目的方式:手动创建和 AI 自动创建。以下分别介绍。

方式一:手动创建(适合已有技术栈)

  1. 登录后,界面中央有一个空白的项目区域,顶部有"Create"按钮
  2. 点击"Create",会弹出模板选择面板
  3. 可以选择以下官方模板:
    • Vanilla:最基础的 HTML + CSS + JS,适合学习
    • React + Vite:最常用的 React 项目模板
    • Vue + Vite:Vue 3 项目模板
    • Svelte:Svelte 框架模板
    • Node.js:后端 Node 项目(可运行 Express、Koa 等)
    • Next.js:全栈 React 框架
  4. 选择模板后,输入项目名称(如"my-first-project"),点击"Create"即可生成项目
  5. 项目创建完成后,会自动打开代码编辑器界面

方式二:AI 自动创建(适合快速原型)

这是 Bolt.new 最核心的功能。你可以直接用自然语言描述你想要的应用,它会为你生成完整的项目结构。

  1. 登录后,在顶部的输入框中(显示"Message Bolt to create an app...")输入你的需求
  2. 例如输入:创建一个 Todo 应用,使用 React + TypeScript,包含添加、完成、删除功能,数据保存在 localStorage
  3. 按下回车,AI 会自动分析需求并开始生成代码
  4. 生成过程中,你可以在终端看到 AI 执行的具体命令(如npm create vite@latest
  5. 生成完成后,页面会自动刷新,显示完整的项目代码和运行效果

2.3 主要功能界面介绍

Bolt.new 的界面布局与 VS Code 类似,分为以下几个区域:

左侧文件树面板(Explorer)

中央代码编辑区(Editor)

右侧预览面板(Preview)

底部终端面板(Terminal)

顶部 AI 对话栏(AI Prompt)

2.4 使用 AI 对话创建功能(完整示例)

下面用一个完整的示例演示如何使用 AI 对话在现有项目中添加功能。

场景:为一个 React 项目添加暗黑模式切换

假设我们已经有了一个使用 React + Vite 创建的项目,现在想添加暗黑模式切换功能。按照以下步骤操作:

  1. 点击界面顶部的 AI 输入框
  2. 输入以下提示词:
为这个 React 应用添加暗黑模式切换功能,要求:
1. 在 Header 组件中添加一个切换按钮(太阳/月亮图标)
2. 使用 CSS 变量实现主题切换
3. 用户选择的主题保存在 localStorage 中,刷新页面保持选择
4. 暗黑模式下背景色为 #1a1a1a,文字色为 #f5f5f5
5. 切换时有平滑的过渡动画(300ms ease)

AI 接收到指令后,会执行以下操作(你可以在终端中看到这些日志):

[AI] 分析当前项目结构...
[AI] 检测到项目使用 React + TypeScript + Vite
[AI] 正在创建 theme.css 文件...
[AI] 正在修改 App.tsx 添加主题状态...
[AI] 正在更新 Header.tsx 添加切换按钮...
[AI] 运行命令: npm install --save-dev lucide-react  # 安装图标库
[AI] 主题切换功能已添加完成

生成完成后,AI 会展示修改的文件列表,你可以点击每个文件查看具体的改动。以下是 AI 可能生成的核心代码示例:

theme.css(新增)

/* 主题变量定义 */
:root {
  --bg-primary: #ffffff;
  --bg-secondary: #f5f5f5;
  --text-primary: #1a1a1a;
  --text-secondary: #666666;
  --transition-speed: 300ms;
}

[data-theme="dark"] {
  --bg-primary: #1a1a1a;
  --bg-secondary: #2d2d2d;
  --text-primary: #f5f5f5;
  --text-secondary: #aaaaaa;
}

/* 应用全局样式 */
body {
  background-color: var(--bg-primary);
  color: var(--text-primary);
  transition: background-color var(--transition-speed) ease,
              color var(--transition-speed) ease;
}

useTheme.ts(新增 Hook)

import { useState, useEffect } from 'react';

// 定义主题类型
type Theme = 'light' | 'dark';

// 从 localStorage 读取保存的主题,没有则默认 light
const getSavedTheme = (): Theme => {
  const saved = localStorage.getItem('app-theme');
  return (saved === 'dark' ? 'dark' : 'light');
};

export function useTheme() {
  // 状态:当前主题
  const [theme, setTheme] = useState<Theme>(getSavedTheme);

  // 副作用:主题变化时写入 localStorage 并更新 DOM 属性
  useEffect(() => {
    localStorage.setItem('app-theme', theme);
    document.documentElement.setAttribute('data-theme', theme);
  }, [theme]);

  // 切换主题函数
  const toggleTheme = () => {
    setTheme(prev => prev === 'light' ? 'dark' : 'light');
  };

  return { theme, toggleTheme };
}

Header.tsx(修改)

import { Sun, Moon } from 'lucide-react';
import { useTheme } from '../hooks/useTheme';

export function Header() {
  // 使用 useTheme Hook 获取当前主题和切换函数
  const { theme, toggleTheme } = useTheme();

  return (
    <header style={{
      padding: '16px 24px',
      display: 'flex',
      justifyContent: 'space-between',
      alignItems: 'center',
      borderBottom: '1px solid var(--bg-secondary)'
    }}>
      <h1>我的应用</h1>

      {/* 主题切换按钮 */}
      <button
        onClick={toggleTheme}
        style={{
          background: 'transparent',
          border: 'none',
          cursor: 'pointer',
          padding: '8px',
          borderRadius: '8px',
          display: 'flex',
          alignItems: 'center',
          justifyContent: 'center'
        }}
        aria-label={theme === 'light' ? '切换到暗黑模式' : '切换到浅色模式'}
      >
        {/* 根据当前主题显示不同图标 */}
        {theme === 'light' ? <Moon size={20} /> : <Sun size={20} />}
      </button>
    </header>
  );
}

2.5 项目导出到本地

Bolt.new 的项目默认托管在 StackBlitz 的云端。如果你想把项目下载到本地继续开发,按照以下步骤操作:

  1. 在 Bolt.new 界面点击左侧文件树上方的"Branch"按钮(显示当前分支名)
  2. 在弹出的面板中选择"Export to GitHub"
  3. 输入一个仓库名称(如 my-bolt-project)
  4. 点击"Create repository"开始导出
  5. 导出完成后,你会得到一个 GitHub 仓库地址,格式为https://github.com/你的用户名/my-bolt-project
  6. 在本地终端执行以下命令克隆到本地:
# 克隆 GitHub 仓库到本地
git clone https://github.com/你的用户名/my-bolt-project.git

# 进入项目目录
cd my-bolt-project

# 安装依赖
npm install

# 启动开发服务器
npm run dev
重要提示:如果你的 GitHub 账号没有配置 SSH Key,导出时可能需要输入账号密码验证。建议提前配置好 SSH Key,避免频繁输入密码。配置方法:ssh-keygen -t ed25519 -C "your_email@example.com",然后将公钥添加到 GitHub Settings。

2.6 AI 辅助编程的常用技巧

以下是经过实战验证的 AI 辅助编程提示词模板,可以显著提升 Bolt.new 的使用效率。

技巧一:分步式开发提示词

# 第一步:创建基础结构
创建一个 React + TypeScript 的待办事项列表应用基础结构

# 第二步:添加功能
在现有的基础上,添加任务分类功能(工作/生活/学习三个分类)

# 第三步:优化体验
添加任务完成时的动画效果,使用 CSS transition

分步式的优点是:AI 每次只需要处理一个小任务,生成结果更准确,出错概率更低。同时你可以随时打断并调整方向。

技巧二:带约束的提示词

用 React 实现一个图片画廊组件,满足以下约束:
- 使用 CSS Grid 布局,响应式设计(桌面3列,平板2列,手机1列)
- 图片使用 lazy loading 优化性能
- 点击图片在 modal 中全屏显示
- 不使用任何第三方 UI 库,只用原生 CSS
- 代码必须包含 TypeScript 类型定义

带约束的提示词让 AI 明确知道你的技术偏好和限制条件,减少无意义的探索。

技巧三:错误修复提示词

终端报错信息:
Error: Module not found: 'react-router-dom'
at MainThreadService.handleFileNotFound (webpack)

当前项目使用 React 18.2.0,请修复这个错误并确保路由功能正常工作。

直接粘贴错误信息让 AI 修复,比笼统地说"项目报错了"效率高得多。

技巧四:代码审查提示词

审查 src/utils/api.ts 文件的代码质量,重点关注:
1. 是否存在安全漏洞(如 XSS、SQL 注入风险)
2. 错误处理是否完善
3. 是否遵循 React 最佳实践
4. TypeScript 类型定义是否准确

2.7 与 Cursor / Windsurf 的对比

下表从多个关键维度对比 Bolt.new、Cursor 和 Windsurf 三款主流 AI 编程工具:

对比维度Bolt.newCursorWindsurf
运行方式纯浏览器,无需安装桌面应用(VS Code 衍生)桌面应用(VS Code 衍生)
环境依赖零配置,云端预装需本地安装 Node.js 等工具需本地安装 Node.js 等工具
AI 模型内置(无需选择)可选 GPT-4 / Claude / Gemini内置(闭源)
代码补全基础(无 Copilot++ 级别)Copilot++ 级别,精准预测Cascade AI,较强
项目创建AI 对话直接生成完整项目模板手动创建,AI 辅助填充代码模板手动创建,AI 辅助填充代码
多文件编辑AI 可一次修改多个文件多 agent 可协调多文件多 agent 可协调多文件
调试能力终端 + 浏览器 DevTools完整 IDE 调试能力完整 IDE 调试能力
离线支持不支持(需要网络)完全支持完全支持
团队协作URL 分享,实时协作需通过 Git 协作需通过 Git 协作
免费额度每天 100 次 AI 请求Pro 版 $20/月(含 500 次快速请求)免费版有限制
最适合场景快速原型、演示分享、轻量级开发专业开发、需要本地能力的长周期项目需要 AI 引导式开发的开发者

三、效果:实际测试数据与对比

3.1 Todo 应用创建速度对比

为了验证 Bolt.new 的实际效率,我们设计了一个对比测试:使用同样的功能需求,分别通过 Bolt.new AI 生成和手动搭建两种方式创建 Todo 应用,然后对比时间消耗和代码质量。

测试任务:创建一个完整的 Todo 应用,功能要求:

测试方法与结果

测试项目Bolt.new AI 生成手动搭建(Vite + React)
环境准备时间0 分钟(打开浏览器即可)约 35 分钟(安装 Node、创建项目、安装依赖)
从需求到可运行项目约 4 分钟(AI 生成 + 自动安装依赖)约 50 分钟(手动编写所有代码)
总耗时约 4 分钟约 85 分钟
生成代码行数(不含依赖)约 286 行(分散在 6 个文件中)约 280 行(手动编写)
功能完整度✅ 全部功能实现,有样式和动画✅ 全部功能实现(基础样式)
类型安全✅ TypeScript 类型完整定义✅ TypeScript 类型完整定义

结论:在同等功能完整度的条件下,Bolt.new 将开发时间从 85 分钟缩短到 4 分钟,效率提升约 21 倍。这个差距主要来自两个方面:AI 生成代码的速度优势,以及云端环境零配置的时间节省。

3.2 AI 生成代码质量评估

我们对比了 Bolt.new AI 生成的代码与手动编写的代码在以下几个维度的表现:

生成代码的不足之处:

3.3 支持的技术栈列表

Bolt.new 支持的前端技术栈非常全面,以下是经过实测确认支持的技术栈:

分类支持的技术栈
前端框架React、Vue 3、Svelte、SvelteKit、Angular(部分)、Solid.js、Qwik
后端框架Express.js、Koa.js、Nest.js(需 Node.js 环境)、Fastify
全栈框架Next.js、Nuxt.js、Astro、Remix
构建工具Vite、Webpack(基础)、esbuild、Rollup
CSS 方案Tailwind CSS(需安装)、CSS Modules、Styled Components、Emotion、Vanilla CSS
UI 组件库Material UI、Ant Design(按需引入)、Radix UI、Headless UI、shadcn/ui(需安装)
状态管理Zustand、Jotai、Redux Toolkit、Recoil、Pinia、React Query、TanStack Query
数据请求Axios、ky、Got、Fetch API、GraphQL(Apollo Client)
测试框架Vitest(推荐)、Jest(需配置)、Playwright(内置)
数据库IndexedDB(客户端)、localStorage、SQLite(需安装)
重要:Bolt.new 基于 WebContainer 技术运行于浏览器中,这意味着它本质上是 Node.js 的浏览器实现。某些依赖原生 Node API(如某些二进制模块、fs.watch、child_process 的完整功能)的包可能无法工作。在大规模引入依赖前,建议先测试核心功能是否正常。

3.4 界面效果描述

以下是 Bolt.new 实际使用时的界面截图描述,帮助你建立直观印象:

图1:Bolt.new 主界面布局
界面分为左右两栏:左侧是文件树和代码编辑器区域,占据约 60% 的宽度;右侧是实时预览面板,占据约 40%。顶部有一条 AI 输入框,横跨整个窗口宽度。底部有一行终端输出区域,可以展开/收起。整个界面色调为浅灰色背景 + 深色代码高亮,风格简洁专业。

图2:AI 对话执行中
当你发送一个 AI 请求后,输入框下方会显示一个进度卡片,上面标注了 AI 正在执行的操作(如"Analyzing project structure"、"Installing dependencies"、"Updating files")。终端区域会同步显示具体的命令执行日志,让你清楚知道 AI 在做什么。

图3:预览面板的响应式切换
点击预览面板工具栏的设备图标(桌面/平板/手机),预览区域会立即切换到对应的视口尺寸。你可以在同一个浏览器标签内快速验证页面在不同设备上的显示效果,无需打开浏览器开发者工具。

四、总结:常见问题与注意事项

4.1 免费额度说明

Bolt.new 的免费额度政策如下:

如果你需要更高的额度(如每月 $15 的 Pro 版:无限 AI 请求、无限项目数量、优先队列),可以点击左下角的用户头像进入订阅页面升级。

4.2 常见报错及解决方案

报错1:Module not found

Error: Module not found: 'axios'
at webpack://MainThreadService.handleFileNotFound

原因:依赖包未安装。

解决:在终端执行以下命令安装:

npm install axios

报错2:Failed to fetch dependencies

Error: Failed to fetch dependencies
npm install exited with code 1
npm error: This is probably not a problem with npm itself.
npm error: Network error

原因:网络连接问题,可能被防火墙拦截或 npm 源访问异常。

解决:尝试以下方法:

# 方法一:切换到国内镜像源
npm config set registry https://registry.npmmirror.com

# 方法二:使用 yarn 替代 npm
npm install -g yarn
yarn install

# 方法三:设置代理(如果有代理服务器)
npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890

报错3:WebContainer timeout

Error: WebContainer boot timeout
The WebContainer failed to start within 30 seconds

原因:浏览器 WebContainer 启动超时,可能是因为浏览器标签页过多或内存不足。

解决:尝试以下方法:

# 方法一:关闭其他不必要的标签页,释放内存

# 方法二:刷新页面,等待 WebContainer 重新初始化

# 方法三:尝试使用 Chrome 的无痕模式(减少扩展程序干扰)

# 方法四:清除浏览器缓存后重试

报错4:AI 请求达到配额限制

Error: AI request limit reached
You have used 100/100 requests today.
Upgrade to Pro for unlimited requests.

原因:免费版每日 100 次 AI 请求额度用完。

解决:

# 方法一:等到 UTC 0 点额度重置(大约北京时间早上8点)

# 方法二:升级到 Pro 版(点击左下角头像 → Subscription)

# 方法三:使用 Cursor 或 Windsurf 作为替代方案

报错5:文件修改冲突

Error: File modification conflict
The file has been modified by another operation.
Please refresh and try again.

原因:AI 修改文件的同时,你也在手动编辑同一个文件,导致写入冲突。

解决:

# 方法一:刷新页面,AI 会重新应用它的修改

# 方法二:如果想保留本地修改,先手动保存修改内容,
# 等 AI 完成后再手动合并

# 方法三:使用 Git 管理版本,随时可以回退

4.3 最佳使用场景

Bolt.new 在以下场景下表现最为出色:

4.4 不能做的事项

Bolt.new 有其局限性,以下场景不适合使用 Bolt.new:

安全提醒:在使用 Bolt.new 时,不要在项目代码中硬编码任何敏感信息(如 API 密钥、数据库密码、私钥等)。即使项目是私有的,也不建议将生产环境的凭据放在 Bolt.new 项目中。正确做法是使用环境变量(.env 文件)并在部署时通过平台配置。

4.5 推荐的组合工作流

根据实际经验,推荐以下组合工作流来最大化 Bolt.new 的价值:

第一步:在 Bolt.new 中完成原型开发
├─ 使用 AI 快速生成基础结构和核心功能
├─ 验证产品方向是否正确
└─ 分享 URL 收集反馈

第二步:导出到本地继续开发
├─ 导出到 GitHub 仓库
├─ 克隆到本地
├─ 使用自己熟悉的 IDE(VS Code / WebStorm)继续开发
└─ 配置本地环境变量和敏感信息

第三步:使用 Git 进行版本管理
├─ 本地开发完成后推送到 GitHub
├─ 通过 CI/CD 自动部署到生产环境
└─ 使用 GitHub Actions 跑测试和构建

这种工作流结合了 Bolt.new 的快速原型能力和本地开发环境的灵活性,是目前最高效的 AI 辅助开发流程之一。