Cline 使用指南

## Cline 简介 Cline（原 Claude Dev）是一个 VS Code 扩展，它将 Claude AI 的能力直接集成到你的编辑器中。与其他 AI 编程工具不同，Cline 可以自主执行复杂的编程任务，包括创建文件、运行命令和浏览网页。 ## 安装 ### 从 VS Code 市场安装 1. 打开 VS Code 2. 按 `Cmd+Shift+X` 打开扩展面板 3. 搜索 "Cline" 4. 点击安装 ### 配置 API Key 安装后需要配置 API Key： 1. 打开 Cline 侧边栏 2. 点击设置图标 3. 选择 API 提供商（Anthropic / OpenAI / OpenRouter 等） 4. 输入 API Key ## 核心功能 ### 自主编程 Cline 可以自主完成编程任务： ``` 创建一个 Express.js REST API，包含用户 CRUD 操作，使用 Prisma ORM 和 MySQL 数据库 ``` Cline 会自动： 1. 初始化项目 2. 安装依赖 3. 配置 Prisma 4. 创建数据模型 5. 实现 API 路由 6. 运行数据库迁移 ### 文件操作 Cline 可以读取、创建和修改文件： - 读取项目中的任何文件 - 创建新文件和目录 - 修改现有文件 - 搜索文件内容 ### 命令执行 Cline 可以在终端中执行命令： ```bash # Cline 会自动运行这些命令 npm install prisma @prisma/client npx prisma init npx prisma migrate dev npm run dev ``` ### 浏览器操作 Cline 可以在浏览器中： - 打开网页 - 截取屏幕截图 - 读取网页内容 - 与网页元素交互 ## 工作模式 ### 自动模式 Cline 自动执行所有步骤，无需确认。适合简单的、低风险的任务。 ### 步骤确认模式 每一步操作都需要用户确认。推荐日常使用。 ### 计划模式 Cline 只制定计划，不执行任何操作。适合复杂任务的规划阶段。 ## 自定义配置 ### .clinerules 文件 在项目根目录创建 `.clinerules` 文件来自定义 Cline 的行为： ``` # .clinerules ## 项目信息 Next.js 15 + TypeScript + Tailwind CSS 项目 ## 代码规范 - 使用 Server Components 优先 - 使用 shadcn/ui 组件库 - API 路由统一返回 { success: boolean, data?: T, error?: string } ## 禁止事项 - 不要修改 prisma/schema.prisma 除非明确要求 - 不要删除任何现有文件 - 不要使用 any 类型 ``` ### 自定义提示词 Cline 支持自定义系统提示词，在设置中配置： ``` 你是一个精通 Next.js 和 TypeScript 的开发者。 在编写代码时，请遵循以下原则： 1. 类型安全优先 2. 错误处理完善 3. 代码简洁可读 4. 性能优化 ``` ## 实战案例 ### 案例 1：创建 API 路由 ``` 在 src/app/api/users/ 下创建用户 API： - GET /api/users - 获取用户列表（支持分页） - GET /api/users/[id] - 获取单个用户 - POST /api/users - 创建用户 - PUT /api/users/[id] - 更新用户 - DELETE /api/users/[id] - 删除用户 使用 Prisma 操作数据库，包含输入验证和错误处理。 ``` ### 案例 2：修复 Bug ``` 用户报告在提交表单时出现 500 错误。 请检查 src/app/api/contact/route.ts 文件， 找出问题并修复。错误日志： TypeError: Cannot read properties of undefined (reading 'email') ``` ### 案例 3：代码重构 ``` 重构 src/components/Dashboard.tsx： 1. 提取数据获取逻辑到单独的函数 2. 将大组件拆分为 3-4 个子组件 3. 添加 loading 和 error 状态 4. 优化性能，避免不必要的重渲染 ``` ## 注意事项 1. **始终审查代码**：Cline 可能生成有 bug 或安全问题的代码 2. **使用版本控制**：在让 Cline 修改代码前确保有 Git 备份 3. **控制权限**：不要在自动模式下执行危险操作 4. **API 费用**：Cline 的 API 调用会产生费用，注意控制用量 ## 总结 Cline 是一个强大的 AI 编程助手，它的自主执行能力让编程变得更加高效。通过合理配置和谨慎使用，Cline 可以成为你开发工作流中的重要工具。