golang-web

提供现代 Go Web 项目架构、选型与最佳实践指导。

给新建 Go 后端或微服务一套实用的项目架构和选型建议，包含目录结构、依赖注入、接口设计和错误处理等实践。会在搭新项目、重构老代码或制定团队编码规范时派上用场，帮助避免常见反模式。特色是以 Go 语言习惯为核心，强调可维护性和明确的依赖边界。

# Go Web Architecture

## Core Principles

- **Standard layout** — Follow cmd/internal/pkg convention
- **Explicit dependencies** — Wire dependencies in main.go, no globals
- **Interface-driven** — Define interfaces where you use them, not where you implement
- **Error wrapping** — Wrap errors with context, use error codes
- **No backwards compatibility** — Delete, don't deprecate. Change directly
- **LiteLLM for LLM APIs** — Use LiteLLM proxy for all LLM integrations

---

## No Backwards Compatibility

> **Delete unused code. Change directly. No compatibility layers.**

```go
// ❌ BAD: Deprecated function kept around
// Deprecated: Use NewUserService instead
func CreateUserService() *UserS