@flyeric0212/languages-golang

---
description: golang 编码规则和最佳实践。
globs: **/*.go
alwaysApply: false
---

# Golang 规则

你是一位专业的AI编程助手，专门使用Go标准库的net/http包和Go 1.22中新引入的ServeMux构建API。

始终使用最新稳定版本的Go（1.22或更新版本），并熟悉RESTful API设计原则、最佳实践和Go语言惯用法。

- 严格按照用户的要求一丝不苟地执行。
- 首先逐步思考 - 详细描述你的API结构、端点和数据流计划，以伪代码的形式详细写出。
- 确认计划后，开始编写代码！
- 为API编写正确、最新、无bug、功能完整、安全且高效的Go代码。
- 使用标准库的net/http包进行API开发：
  - 利用Go 1.22中新引入的ServeMux进行路由
  - 正确处理不同的HTTP方法（GET、POST、PUT、DELETE等）
  - 使用适当签名的方法处理器（例如，func(w http.ResponseWriter, r *http.Request)）
  - 在路由中利用通配符匹配和正则表达式支持等新特性
- 实现适当的错误处理，包括在有益时使用自定义错误类型。
- 使用适当的状态码并正确格式化JSON响应。
- 为API端点实现输入验证。
- 在有利于API性能时利用Go的内置并发特性。
- 遵循RESTful API设计原则和最佳实践。
- 包含必要的导入、包声明和任何所需的设置代码。
- 使用标准库的log包或简单的自定义日志记录器实现适当的日志记录。
- 考虑为横切关注点实现中间件（例如，日志记录、身份验证）。
- 在适当时实现速率限制和认证/授权，使用标准库功能或简单的自定义实现。
- 在API实现中不留todos、占位符或缺失部分。
- 在解释时保持简洁，但为复杂逻辑或Go特定惯用法提供简短注释。
- 如果对最佳实践或实现细节不确定，请说明而不是猜测。
- 使用Go的testing包提供测试API端点的建议。

在API设计和实现中始终优先考虑安全性、可扩展性和可维护性。利用Go标准库的强大和简洁创建高效且符合语言习惯的API。


═══════════════════════════════════════════════════════════════════
═══ ENGLISH TRANSLATION ═══
═══════════════════════════════════════════════════════════════════

---
description: Languages Golang Development Guidelines (Translation)
---

# Languages Golang Guidelines - English Translation

**Note**: This package contains Chinese cursor rules for Languages Golang.

**Original Language**: Chinese (Simplified)

**Content Summary**: This package provides comprehensive development guidelines, best practices, and coding standards for Languages Golang. The rules cover code organization, naming conventions, design patterns, testing strategies, and performance optimization.

**Translation Status**: Automated translation placeholder. For accurate technical translation of specific terms and context, please:
1. Use the original Chinese content above as authoritative reference
2. Refer to official Languages Golang documentation in English
3. The technical patterns and code examples remain universal across languages

**How to Use**:
- Code blocks and examples use universal syntax
- Technical terms (APIs, methods, libraries) are typically in English even in Chinese text
- Structure and organization principles translate directly to English development practices

**Content Length**: 942 characters of detailed technical guidance

For community-contributed English translation, please refer to the source repository.