AI Agent / 系统课时
搭建本地开发环境
搭建本地开发环境
本节将完成 Vibe Coding 所需的本地开发环境搭建,包括编辑器、终端、运行时、版本控制和基础依赖配置。完成后,你将拥有一个可以接收 AI 协作、编写代码并快速验证结果的稳定工作空间。
学习目标
- 了解 AI 协作开发环境的组成部分和职责。
- 完成编辑器、终端、运行时和 Git 的基础配置。
- 掌握验证环境是否可用的方法。
开发环境的组成
Vibe Coding 的核心不是替代开发工具,而是在已有工程环境中增加 AI 协作能力。一个完整环境通常包含编辑器、终端、运行时、版本控制和项目依赖五部分。

编辑器负责代码查看和修改,终端负责执行命令,运行时提供程序执行能力,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 生成代码无法运行时,先确认本地环境是否满足要求,再判断代码本身是否存在问题。稳定环境是高效协作的前提。
按自己的节奏,确认真正理解。