@Codebase 命令

引言

@Codebase 命令是 Cursor 中用于处理整个代码库的上下文命令。它允许您在与 AI 助手对话时引用和分析整个项目的代码结构、依赖关系、架构设计等。这个功能特别适合需要理解项目整体架构、进行代码重构、或优化系统设计的场景。

使用 @Codebase 命令分析项目结构，获取 AI 助手的全局视角。

基本用法

1. 概览分析

分析整个代码库的概况。

@Codebase:overview

2. 依赖分析

分析特定目录的依赖关系。

@Codebase:deps src/components

3. 架构评估

评估项目的架构设计。

@Codebase:architecture

高级功能

1. 代码质量分析

分析代码质量指标。

@Codebase:quality --metrics=complexity,duplication

2. 技术栈识别

识别项目使用的技术栈和框架。

@Codebase:stack

3. 模式检测

检测代码中的设计模式和反模式。

@Codebase:patterns

常见使用场景

1. 项目评估

这个项目的整体架构如何？

@Codebase:analyze

项目分析结果：

采用 MVC 架构模式
模块化程度良好
存在部分耦合问题
测试覆盖率需要提升

2. 重构建议

如何改进代码结构？

@Codebase:refactor-suggestions

重构建议：

提取公共组件
优化数据流
减少循环依赖
增加单元测试

3. 性能优化

项目有哪些性能瓶颈？

@Codebase:performance

性能分析：

数据库查询优化
缓存策略改进
资源加载优化
并发处理优化

最佳实践

项目结构
保持清晰的项目结构，便于分析和维护。
代码组织
合理组织代码，避免过度复杂的依赖关系。
文档维护
及时更新文档，保持与代码的一致性。
性能监控
定期进行性能分析和优化。

故障排除

问题：分析问题

解决方案：

确保代码库已完全索引
检查文件权限设置
验证依赖完整性

问题：性能问题