Cline 本身不是独立项目管理器，它是基于 VSCode 工作空间（Workspace）的 AI 编程代理；项目边界由 VSCode 的文件夹 / 工作空间定义，Cline 在当前打开的 workspace 内读写文件、执行任务、保存项目上下文。
一、基础：项目与工作空间绑定
1. 单项目（单文件夹）
- VSCode：
文件 → 打开文件夹，选中你的项目根目录（必须先打开文件夹，Cline 才能读写文件） - Cline 面板会识别当前文件夹作为项目根目录，所有操作限定在此目录内
⚠️ 不打开文件夹直接用 Cline，它无法创建 / 修改文件
2. 多项目（多根工作空间 Monorepo）
VSCode：文件 → 将文件夹添加到工作区，可把多个仓库加到同一个窗口，Cline 可跨多个文件夹读 / 写代码
限制：
.clinerules仅生效于主工作区文件夹- Checkpoints（快照回滚）在多根工作空间会被禁用，切回单文件夹自动恢复
- 推荐复杂多项目使用
.code-workspace文件保存工作区配置，团队共享
二、项目级规则：.clinerules（项目专属指令）
在项目根新建 .clinerules 文件，Git 可提交，Cline 每次进入项目自动读取：
- 编码规范、架构约束、禁止修改目录、命令规范
- 项目专属提示词，例如：所有代码必须写单元测试、禁止修改
config/prod.js
示例：
你是本项目后端开发，遵循： 1. 只修改 src/ 下代码，不改动 deploy/ 2. 修改后先运行 npm lint 3. 输出改动文件清单
三、项目长期记忆：Memory Bank（核心项目管理能力）
解决关闭 VSCode、新开对话后，Cline 忘记项目信息的问题，在项目目录新建 memory-bank/，放一组 Markdown 文件，Cline 跨会话读取项目信息：
memory-bank/ ├── projectbrief.md # 项目目标、需求 ├── productContext.md # 业务背景 ├── systemPatterns.md # 架构、模块关系 ├── techContext.md # 技术栈、环境、依赖 ├── activeContext.md # 当前开发焦点、最近改动 └── progress.md # 进度、待办、已知bug
使用方式：
- 首次初始化：
Cline，初始化 Memory Bank - 每次开发让 Cline 自动更新
activeContext.md、progress.md - 换机器 / 重启 VSCode，Cline 读取 memory-bank，恢复项目上下文
四、任务管理（Cline 会话管理）
Cline 的对话就是任务，一个项目可以有多个任务：
/newtask：新建任务，把上一轮的总结、文件上下文打包封存，开启干净新会话（推荐功能，防止上下文膨胀）/compact//smol：压缩当前对话历史，保留关键信息，减少 token 消耗- 切换项目：关闭当前工作区 → 打开另一个项目文件夹，Cline 自动切换上下文；不同项目任务相互隔离
快捷引用文件：在对话输入框使用
@文件名，直接把文件引入当前对话上下文，不需要复制代码
五、项目变更快照 Checkpoints（安全回滚）
Cline 在执行每一步修改时自动创建工作区快照：
- Compare：对比当前代码与快照差异
- Restore Workspace Only：仅回滚代码文件，保留对话任务
- Restore Task and Workspace：回滚代码 + 重置当前任务到快照点
注意：多根工作空间下 Checkpoints 不可用
六、权限控制（项目安全）
Cline 可以读文件、写代码、执行终端命令，每个项目独立权限设置：
打开 Cline 设置 → Auto-approve（自动批准）：
- Read files：读取文件
- Write files：写入 / 修改文件
- Run commands：执行终端命令（安装依赖、构建脚本）
- Use browser：浏览器工具
建议：新项目默认全部手动确认；信任项目再开启自动批准，防止误删文件
七、MCP 扩展项目能力（可选）
MCP（Model Context Protocol）给 Cline 增加项目管理工具：
- GitHub MCP：读取 issues、创建 PR
- File system MCP：高级目录扫描
- Git MCP：查看提交、diff
配置：Cline 设置 → MCP Servers，可以全局配置，也可以项目本地配置
八、推荐项目管理工作流
- 新建项目文件夹，VSCode 打开
- 新建
.clinerules，定义项目规范 - 执行：
Cline，初始化 memory-bank，记录项目需求与技术栈 - 开启功能开发，每完成一个模块：
更新 memory-bank/progress.md - 切换新功能时：
/newtask - 代码改动出错：使用 Checkpoints Restore 回滚
- 提交 Git，
.clinerules、memory-bank 一起纳入版本管理
九、常见坑
- ❌ 不打开文件夹直接用 Cline：无法写文件
- ❌ 多根工作空间下想使用 Checkpoints：不支持，拆成独立项目窗口
- ❌ 长任务不做
/newtask：对话越来越长，token 消耗高，模型容易遗忘早期需求 - ❌ 不同项目共用同一个 Cline 会话：上下文串扰，切换项目必须新开工作区