跳到主要内容

Cursor 协作编码：AI 结对编程与团队工作流

Cursor Collaborative Coding

Cursor 将 AI 辅助引入了团队协作，实现了共享的编码标准、一致的 AI 行为和简化的代码审查。本指南涵盖团队设置、共享配置以及在 Cursor 中协作编码。

前置条件​

在开始之前：

  • Cursor 已安装（建议使用团队许可证）
  • 团队使用的共享代码仓库
  • 对 Git 工作流有基本了解

团队范围的 AI 配置​

创建 .cursorrules​

.cursorrules 文件为您的团队定义 AI 行为：

# 项目：SaaS 仪表板应用
# 技术栈：React, TypeScript, Tailwind, Node.js

## 编码标准
- 所有组件使用 TypeScript
- 所有 UI 元素使用 Tailwind CSS
- 遵循项目中已有的命名规范
- 编写测试用于所有新功能

## 架构决策
- 使用 React Query 进行服务端状态管理
- 使用 Zustand 进行客户端状态管理
- 优先使用服务端组件（Server Components）
- API 路由遵循 RESTful 规范

## AI 行为
- 生成代码时始终包含 JSDoc 注释
- 建议性能优化方案
- 标记潜在的安全问题
- 使用项目中已有的工具函数

共享的 Cursor 配置​

// .cursor/settings.json
{
  "cursor.aiRules": "./.cursorrules",
  "cursor.defaultModel": "claude-sonnet-4",
  "cursor.formatOnSave": true,
  "cursor.tabSize": 2,
  "cursor.preferredImportStyle": "absolute",
  "cursor.testingFramework": "vitest"
}

AI 结对编程​

共享 AI 上下文​

@workspace 解释我们的认证流程是如何工作的

AI 会分析：

  • 当前项目的代码库
  • .cursorrules 配置
  • 最近编辑的文件
  • 打开的 tabs

代码审查工作流​

  1. 提交前审查：
审查此函数可能存在的问题：
- 边缘情况
- 性能问题
- 安全漏洞
- 类型安全
  1. AI 辅助 PR 描述：
根据这些更改生成 PR 描述：
- 列出修改的文件
- 解释关键更改
- 标记破坏性变更

团队编码模式​

一致的文件结构​

src/
  components/
    ui/              # 可复用的 UI 组件
    features/        # 特定功能的组件
  hooks/
    api/             # 数据获取 hooks
    ui/              # UI 交互 hooks
  utils/
    api.ts           # API 工具函数
    formatting.ts    # 格式化工具函数
    validation.ts    # 验证工具函数

共享组件模式​

// components/ui/Button.tsx
interface ButtonProps {
  variant?: 'primary' | 'secondary' | 'danger';
  size?: 'sm' | 'md' | 'lg';
  isLoading?: boolean;
  children: React.ReactNode;
}

export function Button({
  variant = 'primary',
  size = 'md',
  isLoading = false,
  children,
  ...props
}: ButtonProps) {
  const baseStyles = 'rounded font-medium transition-colors';
  const variantStyles = {
    primary: 'bg-blue-600 text-white hover:bg-blue-700',
    secondary: 'bg-gray-200 text-gray-800 hover:bg-gray-300',
    danger: 'bg-red-600 text-white hover:bg-red-700',
  };
  const sizeStyles = {
    sm: 'px-3 py-1.5 text-sm',
    md: 'px-4 py-2 text-base',
    lg: 'px-6 py-3 text-lg',
  };

  return (
    <button
      className={`${baseStyles} ${variantStyles[variant]} ${sizeStyles[size]}`}
      disabled={isLoading}
      {...props}
    >
      {isLoading ? <Spinner /> : children}
    </button>
  );
}

实时协作​

使用 Live Share（通过 VS Code 扩展）​

  1. 安装 VS Code Live Share 扩展
  2. 开始协作会话
  3. 共享链接给团队成员
  4. 实时共同编辑

Cursor 特定的共享​

# 共享 AI 上下文
@workspace 与 @teammate 共享此分析

# 共享特定文件
@file src/auth/login.ts 解释登录流程

代码审查最佳实践​

AI 辅助审查清单​

审查此 PR 的更改：
1. 检查是否符合我们的 .cursorrules
2. 识别潜在的回归问题
3. 验证类型安全
4. 检查是否有足够的测试覆盖
5. 标记任何安全问题

团队约定​

约定示例
分支命名feature/user-auth, bugfix/login-error
提交信息feat: add user authentication
PR 模板包含描述、截图、测试清单
代码所有者@team-lead 用于关键文件

共享代码片段​

团队片段库​

// .cursor/snippets.json
{
  "React Component": {
    "prefix": "rfc",
    "body": [
      "interface ${1:Component}Props {",
      "  ${2:prop}: ${3:type};",
      "}",
      "",
      "export function ${1:Component}({ ${2:prop} }: ${1:Component}Props) {",
      "  return (",
      "    <div>",
      "      $0",
      "    </div>",
      "  );",
      "}"
    ]
  },
  "API Hook": {
    "prefix": "apihook",
    "body": [
      "export function use${1:Resource}() {",
      "  return useQuery({",
      "    queryKey: ['${2:resource}'],",
      "    queryFn: fetch${1:Resource},",
      "  });",
      "}"
    ]
  }
}

故障排除​

常见问题​

问题：AI 建议与我们的标准不一致
解决方案：更新 .cursorrules 并提供更多上下文

问题：团队成员获得不同的 AI 响应
解决方案：标准化 .cursorrules 和模型选择

问题：大型代码库中的上下文丢失
解决方案：使用 @file 引用特定文件

相关资源​

最后更新：2025 年 7 月