为什么 multi-file 改动比单文件危险得多？

4 类高频翻车：(1) 重复造已有的 utility 函数；(2) 改了调用方忘改类型定义；(3) import 被 AI 顺手清错；(4) 改动半径超出原本需求。单文件错了一眼能看出，跨文件错了 reviewer 也容易漏 —— 接口、类型、import、状态流、样式、测试可能一起被带偏，回归排查成本翻 5 倍。

改动多文件之前应该先让 AI 做什么？

两步铺垫："(1) 先不要改代码，根据 src/app + src/components + src/services + src/types 这些路径，总结项目结构 —— 每个目录作用、这次任务最可能改哪些文件、哪些不该碰；(2) 列 change list —— 改哪些文件、为什么改、依赖关系、可能影响哪些现有逻辑。"这两步 5 分钟做完，能拦下 80% 的"AI 又造了一份现有 utility"。

怎么明确告诉 AI 哪些文件不准动？

在 prompt 里写显式 boundary："只允许修改 [file A, file B]；禁止修改 [file C, file D]；不能新增 dependency；不能重构 shared 逻辑。"千万别说"重构整个模块"—— 那等于发无限权限。明确范围后 AI 跑偏概率从 40% 掉到 5%。最稳的句式是把"不要碰什么"写在前面，比"只改什么"更有约束力。

Multi-file 改完后最小 validation checklist 应该跑什么？

4 项必跑：(1) typecheck —— 接口对齐没；(2) 最小 smoke test —— 改动涉及的关键页面手测一遍；(3) import / export 检查 —— 有没有循环依赖或漏 export；(4) 关键路径手测 —— 用户实际用到的核心 flow 走一遍。让 AI 帮你列这份 checklist："基于这次改动，列出最小验证清单 —— 跑哪些命令、测哪些页面、哪些边界最容易坏。"

改 API contract 时为什么要按层逐步改？

API contract 一变，type 定义、service 调用、UI 渲染三处必须同步。一次让 AI 全改完看似快，实际上 reviewer 看不出哪层先错 —— type 错还是 service 错？按层走的顺序是 type → service → UI，每层改完先 typecheck 再进下一层。Vibe Coding 在 multi-file 场景的核心原则不是"快"，而是"每步可追踪"。

多文件协作与项目级修改

学AI来匠人

📖

Vibe Coding

38 节

·简介

基础篇6

01
Vibe Coding 是什么
5分钟
02
安装 Cursor 与环境准备
10分钟
03
写出第一个 Prompt
10分钟
04
Vibe Coding 思维模型
8分钟
05
高质量 Prompt 模板
12分钟
06
理解与校验 AI 的回复
10分钟

进阶篇18

07
🔒用 AI 做 Debug
20分钟
08
🔒与 AI 结对编程
18分钟
09
🔒多文件协作与项目级修改
25分钟
10
🔒交付一个小功能的全流程
30分钟
11
🔒用 AI 做测试与质量保障
20分钟
12
性能与成本优化
18分钟
13
安全与隐私最佳实践
15分钟
14
🔒团队协作与 PR 流程
18分钟
15
工具与模型最新动态
12分钟
16
🔒AI Agents 与工具调用
25分钟
17
🔒前后端协同与 API 生成
25分钟
18
🔒数据与知识库协作
22分钟
19
持续改进与自动化
18分钟
20
🔒AI 辅助重构与架构演进
22分钟
21
AI 辅助 UX 文案与交互
15分钟
22
🔒可观测性与 Guardrails
18分钟
23
脚手架与自动化交付
15分钟
24
🔒实战：Todo App
45分钟

工具篇13

25
🔒MCP 服务器配置
20分钟
26
🔒MCP 配置同步
15分钟
27
Cursor Rules 编写指南
15分钟
28
Git Commit 规范与 Emoji
10分钟
29
五个为什么分析法
8分钟
30
Mermaid 图表生成
12分钟
31
任务实施方法论
10分钟
32
Claude Code Skills 进阶
15分钟
33
Claude Code + GLM 4.6 配置
15分钟
34
Claude Code 自定义命令
12分钟
35
Claude Code 子代理配置
15分钟
36
Claude Code 全面拆解
25分钟
37
Claude Skill Codebook 简明教程
12分钟

实战篇1

38
Vibe Coding 全流程 SOP
15分钟

🎯学习更高效

让你的学习不被打断

✏️
学习笔记
边学边记，云端同步
📈
进度追踪
自动保存，随时继续
🏅
完课证书
可分享的学习成就
💬
社区答疑
和 2000+ 学员交流

免费注册→已有账号？登录

👥2,847 人正在学习

AI学习面试课程学习中心