AI Agent / 系统课时

搭建本地开发环境

搭建本地开发环境

本节将完成 Vibe Coding 所需的本地开发环境搭建,包括编辑器、终端、运行时、版本控制和基础依赖配置。完成后,你将拥有一个可以接收 AI 协作、编写代码并快速验证结果的稳定工作空间。

学习目标

  • 了解 AI 协作开发环境的组成部分和职责。
  • 完成编辑器、终端、运行时和 Git 的基础配置。
  • 掌握验证环境是否可用的方法。

开发环境的组成

Vibe Coding 的核心不是替代开发工具,而是在已有工程环境中增加 AI 协作能力。一个完整环境通常包含编辑器、终端、运行时、版本控制和项目依赖五部分。

Vibe Coding 本地开发环境组成结构图

编辑器负责代码查看和修改,终端负责执行命令,运行时提供程序执行能力,Git 保存版本变化,项目依赖保证应用能够正常构建。缺少其中任意一环,AI 生成的代码都可能无法验证。

安装基础工具

以常见 JavaScript 开发环境为例,首先安装运行时和版本控制工具。不同语言生态对应不同运行时,例如 Python 项目需要 Python 环境,Java 项目需要 JDK。

安装完成后,可以通过命令检查版本信息,确认工具已经加入系统路径。

bash
node --version
git --version

预期输出:

text
v<MAJOR>.<MINOR>.<PATCH>
git version <VERSION>

实际版本号会随安装时间变化,只要能够正常返回版本信息,就说明基础环境已经生效。

配置编辑器与终端

编辑器需要具备代码高亮、扩展管理和终端集成功能。使用 AI 协作时,建议保持项目文件结构清晰,并安装必要的语言支持插件。

终端配置重点是确认默认 Shell、权限和路径设置正确。后续创建项目、安装依赖和运行测试都会依赖终端环境。常见检查包括:

  • 当前用户拥有项目目录读写权限。
  • 运行时命令可以在任意目录执行。
  • Git 可以正常初始化和提交代码。

创建验证项目

完成工具安装后,可以创建一个最小项目验证环境。

bash
mkdir ai-demo
cd ai-demo
npm init -y
node -e "console.log('environment ready')"

预期输出:

text
environment ready

如果命令执行失败,应优先检查运行时安装、环境变量和终端重新加载状态,而不是直接修改项目代码。

常见环境问题

开发环境问题通常集中在路径、权限和版本冲突三个方向。多个版本的运行时并存时,需要使用版本管理工具固定项目版本。

当 AI 生成代码无法运行时,先确认本地环境是否满足要求,再判断代码本身是否存在问题。稳定环境是高效协作的前提。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建本地开发环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通