AI4SE_Practices/AI4SE-survey/tools/documentation/CodeGPT/overview.md

4.3 KiB
Raw Blame History

CodeGPT - 工具概览

工具类型:文档生成
工具分类Documentation
最后更新2025-11-26

📋 基本信息

工具简介

  • 核心功能:作为 AI 代码助手核心覆盖文档生成代码注释、API 文档、README支持批量生成与自定义模板同时具备代码补全、调试等辅助功能文档生成基于代码逻辑自动推导

  • 适用场景:多语言项目文档快速补全、开源项目 README 初稿生成、团队代码注释标准化、无网络环境下本地文档生成

  • 开发主体CodeGPT 开源组织GitHub Stars 7.8k+

官方网站

定价信息

  • 免费版开源核心功能全免费文档生成、代码补全支持接入免费开源模型CodeLlama、Llama 2 等)
  • 付费版CodeGPT Cloud$10 / 月),提供 GPT-4 Turbo/Claude 3 等商业模型接口,无需本地部署
  • 开源开源MIT License

大模型底座

  • 底层模型:支持多种模型选择
    • 开源模型CodeLlama、Llama 2、Mistral、StarCoder等
    • 商业模型GPT-4 Turbo、Claude 3、Gemini Pro等
    • 本地模型支持通过Ollama等工具使用本地模型

🎯 核心功能

主要功能

  1. 代码注释:支持 Google Style Docstring、JSDoc、Javadoc 等主流风格,可自定义模板
  2. README.md 自动生成与更新包含快速开始、API 列表、安装依赖等核心模块
  3. API 文档:支持导出 Markdown/HTML 格式,部分模型兼容 OpenAPI/Swagger 规范

适用场景

  • 支持本地部署:离线可用,适配涉密项目
  • 批量生成文档:支持整个项目 / 目录批量添加注释、生成统一 API 文档
  • 自定义注释字段:可添加团队所需字段

不适用场景

  • 自动更新需求:文档生成需手动触发,无自动监听代码变更实时更新功能
  • 复杂继承关系:对复杂继承关系的类注释完整性不足,易遗漏父类方法说明
  • 特定行业术语:对于金融、医疗等特定领域的专业术语理解有限

🛠️ 技术栈支持

支持的编程语言

  • Python 完全支持版本要求3.8+
  • JavaScript/TypeScript 完全支持
  • Java 完全支持
  • Go 完全支持
  • C/C++ 支持
  • C# 支持
  • PHP 支持
  • Ruby 支持
  • Rust 支持
  • Kotlin 支持
  • Swift 支持

支持的框架

  • Web框架FastAPI、Flask、Django、Express.js、React、Vue、Angular、Spring Boot等
  • 数据库PostgreSQL、MySQL、MongoDB、Redis、SQLite等
  • 其他Docker、Kubernetes、TensorFlow、PyTorch等主流框架

IDE集成

  • VS Code 完全支持插件CodeGPT
  • IntelliJ IDEA 完全支持插件CodeGPT
  • PyCharm 完全支持插件CodeGPT
  • WebStorm 支持
  • Android Studio 支持
  • 其他JetBrains IDEs 支持

🚀 部署方式

云端服务

  • SaaS 支持(提供云端服务)
  • API 支持提供API接口

本地部署

  • 本地安装 支持方式IDE插件
  • 本地模型 支持通过Ollama、LM Studio等工具运行本地模型

混合部署

  • 本地+云端 支持(描述混合模式)

📊 版本信息

当前版本

  • 版本号v3.8.0+
  • 发布日期2024-11
  • 最后更新2024-11

版本历史

  • v3.8.02024-11增强文档生成功能支持更多编程语言
  • v3.5.02024-09添加自定义注释模板功能
  • v3.0.02024-06重构核心架构提升性能

🔗 相关资源

学习资源

社区

相关工具

  • GitHub Copilot商业化的AI代码助手功能更全面但需付费
  • Cursor集成AI的代码编辑器适合完整项目开发
  • Tabnine专注于代码补全的AI工具