使用 Homebrew, MacPorts, Nix, scoop 安装 google-java-format

项目链接

• 主页
• 上游文档
• 软件包管理器页面

命令和别名

• google-java-format
• google-java-format-diff

项目历史

Google opened the GitHub repository in May 2015 and published a 0.1 Alpha release in November 2015. The 1.0 release followed in April 2016, establishing the formatter as a packaged tool rather than only an internal style convention.

The README describes several integration surfaces around the same formatter engine: a command-line jar or native binary, a diff-oriented helper script, JetBrains and Eclipse plugins, and use as a Java library from Maven or Gradle builds. That shape made the project useful both for individual developer machines and for automated formatting checks.

采用历史

Adoption grew through the Java tooling ecosystem because the formatter is intentionally prescriptive. The official README lists third-party integrations for Visual Studio Code, Gradle, Maven, SBT, and GitHub Actions, showing how package maintainers and build-tool authors wrapped the same formatter for their own workflows.

Package-manager adoption followed the CLI packaging model: Homebrew, MacPorts, Nix, and Scoop package the formatter so users can run `google-java-format` or `google-java-format-diff` without hand-managing the release jar.

使用方式

The common package-manager use is formatting whole Java files from the shell, rewriting files in place with `--replace`, checking changed lines with the diff helper, or enforcing style in CI with a nonzero exit when files differ. The library mode supports code generators and build tools that need formatted Java output.

The formatter depends on javac internals through the `jdk.compiler` module, so editor and library integrations document extra JVM export flags on strongly encapsulated JDKs.

为什么软件包爱好者会关心

google-java-format matters to package nerds because it packages a style guide as executable policy. It is a canonical example of a formatter with almost no bikeshed surface: installation, editor integration, and CI wiring matter more than local configuration.

It also sits at the intersection of Java release engineering and package distribution: jars, native binaries, IDE plugins, Maven artifacts, and OS package-manager formulae all expose the same opinionated formatting behavior.

时间线

• 2015: GitHub repository created under google/google-java-format.
• 2015: 0.1 Alpha published on GitHub Releases.
• 2016: 1.0 release published on GitHub Releases.
• 2017: 1.x releases added a steady release cadence for package managers and editor integrations.
• 2021: JDK strong encapsulation made the documented `--add-exports` flags important for plugin and library users.

Related projects

• The README points to Google Java Style, the IntelliJ and Eclipse plugins, google-java-format-diff, Spotless Gradle and Maven integrations, fmt-maven-plugin, sbt-java-formatter, and GitHub Actions wrappers.

来源

• https://api.github.com/repos/google/google-java-format
• https://github.com/google/google-java-format
• https://github.com/google/google-java-format#readme
• https://github.com/google/google-java-format/releases