# alibaba/Alibaba-Java-Coding-Guidelines

Gitbook for AJCG

Repository: https://github.com/alibaba/Alibaba-Java-Coding-Guidelines
Canonical: https://ross.abutalabs.com/products/alibaba-java-coding-guidelines
Homepage: https://alibaba.github.io/Alibaba-Java-Coding-Guidelines/
License Family: other
Last push: 2023-01-06T06:54:40+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3488, "days_push": 1335, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1057, forks 244 (observed 2026-08-28T04:03:24.792639+00:00)

## What it is
The Alibaba Java Coding Guidelines (AJCG) is a Gitbook document consolidating Alibaba's Java programming best practices, covering programming specification, exceptions and logs, MySQL rules, project structure, and security. Each rule is classified as Mandatory, Recommended, or Reference, with positive and counter examples.

## Use cases
- learn java coding standards
- improve java code quality in my team
- find best practices for java naming and formatting
- mysql schema and index design guidelines
- java security coding checklist
- establish code review standards for java projects

## When to choose
- you want a battle-tested, widely adopted Java style and quality guide
- you need rules graded by severity with concrete examples
- your team works with Java and MySQL and wants shared conventions

## When to avoid
- you need an executable linter rather than a document (use P3C/PMD plugins)
- you want language-agnostic style rules
- you need guidelines for languages other than Java

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: documentation, linter, code-review
- domain: developer-tools, programming-languages, documentation, databases, security
- platform: jvm
- tags: java-coding-guidelines, coding-standards, code-quality, best-practices, gitbook

## Member repositories
- alibaba/Alibaba-Java-Coding-Guidelines (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:24.792639+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:57:55.459746+00:00, confidence not recorded.
  - readme: https://github.com/alibaba/Alibaba-Java-Coding-Guidelines (fetched 2026-08-28T04:03:24.792639+00:00, sha 6d90f7710fb4)
  - homepage: https://alibaba.github.io/Alibaba-Java-Coding-Guidelines/ (fetched 2026-08-29T12:59:54.025621+00:00, sha 8ded479b72b6)
- Data as of 2026-08-30T08:39:29.467469+00:00.
