google/google-java-format hiện có 6.2k sao trên GitHub, viết chủ yếu bằng Java. Reformats Java source code to comply with Google Java Style.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Note that it uses the jdk.compiler module to parse the Java source code. The
java binary version used must therefore be from a JDK (not JRE) with a version
equal to or newer than the Java language version of the files being formatted.
The minimum Java version can be found in
pom.xml
(currently Java 21). An alternative is to use the available GraalVM based native
binaries instead.
The formatter can act on whole files, on limited lines (--lines), on specific
offsets (--offset), passing through to standard-out (default) or altered
in-place (--replace).
Option --help will print full usage details; including built-in documentation
about other flags, such as --style, --max-line-length, --fix-imports-only,
--skip-sorting-imports, --skip-removing-unused-import,
--skip-reflowing-long-strings, --skip-javadoc-formatting, or the --dry-run
and --set-exit-if-changed.
Using @<filename> reads options and filenames from a file, instead of
arguments.
To reformat changed lines in a specific patch, use
google-java-format-diff.py.
Note:There is almost no configurability as to the formatter's algorithm
for formatting. This is a deliberate design decision to unify our code
formatting on a single format. See Configuration for the few
options that are available.
IntelliJ, Android Studio, and other JetBrains IDEs
A
google-java-format IntelliJ plugin
is available from the plugin repository. To install it, go to your IDE's
settings and select the Plugins category. Click the Marketplace tab, search
for the google-java-format plugin, and click the Install button.
The plugin will be disabled by default. To enable,
open the Project settings,
then click "google-java-format Settings" and check the "Enable
google-java-format" checkbox.
To enable it by default in new projects,
open the default settings for new projects
and configure it under "Other Settings/google-java-format Settings".
When enabled, it will replace the normal Reformat Code and Optimize Imports
actions.
IntelliJ JRE Config
The google-java-format plugin uses some internal classes that aren't available
without extra configuration. To use the plugin, you need to
add some options to your IDE's Java runtime.
To do that, go to Help→Edit Custom VM Options... and paste in these lines:
The latest version of the google-java-format Eclipse plugin can be downloaded
from the releases page.
Drop it into the Eclipse
drop-ins folder
to activate the plugin.
The plugin adds two formatter implementations:
google-java-format: using 2 spaces indent
aosp-java-format: using 4 spaces indent
These that can be selected in "Window" > "Preferences" > "Java" > "Code Style" >
"Formatter" > "Formatter Implementation".
Eclipse JRE Config
The plugin uses some internal classes that aren't available without extra
configuration. To use the plugin, you will need to edit the
eclipse.ini file.
Open the eclipse.ini file in any editor and paste in these lines towards the
end (but anywhere after -vmargs will do):
Cosium/maven-git-code-format:
A maven plugin that automatically deploys google-java-format as a
pre-commit git hook.
SBT plugins
sbt/sbt-java-formatter
Github Actions
googlejavaformat-action:
Automatically format your Java files when you push on github
as a library
The formatter can be used in software which generates java to output more
legible java code. Just include the library in your maven/gradle/etc.
configuration.
google-java-format uses internal javac APIs for parsing Java source. The
following JVM flags are required when running on JDK 16 and newer, due to
JEP 396: Strongly Encapsulate JDK Internals by Default:
Your starting point should be the instance methods of
com.google.googlejavaformat.java.Formatter.
Configuration
google-java-format is an opinionated formatter with very little configuration.
Its core formatting decisions, like where lines break and how much continuation
lines are indented, are deliberately not configurable. See also
this FAQ entry
for more details.
There are a few configuration options for projects that need them:
--style=google|aosp selects the code style. The default, google, follows
Google Java Style. aosp follows the
AOSP Java code style:
it indents blocks by 4 spaces and continuation lines by 8, instead of 2
and 4. Line breaking is otherwise the same as Google style, so
--style=aosp is also an option for projects that want 4-space indentation
without otherwise following AOSP conventions. (--google-style and --aosp
are equivalent shorthands.)
--max-line-length=N sets the column limit. The default is 100.
Besides layout, the formatter makes some changes that aren't just whitespace,
and each of them can be turned off:
--cleanup=false disables small cleanups such as removing redundant
semicolons, empty annotation parentheses (@Foo() to @Foo), and
parentheses around a single lambda parameter ((x) -> ... to x -> ...).
Cleanups are enabled by default, and only apply to the lines being
formatted.
--skip-sorting-imports and --skip-removing-unused-imports disable import
sorting and unused import removal (--fix-imports-only does only those, and
no other formatting).
--skip-reordering-modifiers keeps modifiers in their existing order.
--skip-reflowing-long-strings disables splitting string literals that
exceed the column limit.
Run google-java-format --help for the full command-line reference. When using
the formatter as a library, JavaFormatterOptions.builder() and
JavaFormatterOptions.Style.builder() provide the corresponding options.
Building from source
mvn install
Contributing
Please see the contributors guide for details.
License
Copyright 2015 Google Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.
google/google-java-format có 6.2k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/google/google-java-format. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
google/google-java-format có những chủ đề gì?
GitHub topics của google/google-java-format: "formatter", "java". TopGit xếp repo vào nhóm Developer Tools.
google/google-java-format còn đang phát triển không?
Commit gần nhất trên google/google-java-format là 3 tháng trước (theo timestamp GitHub). Repo có 946 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
google/google-java-format là gì?
google/google-java-format (google/google-java-format) là dự án Java trên GitHub. Theo mô tả gốc: Reformats Java source code to comply with Google Java Style.
google/google-java-format so với các dự án Developer Tools khác thế nào?
google/google-java-format được TopGit xếp vào nhóm Developer Tools, với 6.2k sao GitHub và viết bằng Java. Xem trang chủ đề Developer Tools trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
google/google-java-format viết bằng ngôn ngữ gì?
google/google-java-format chủ yếu viết bằng Java. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Vì sao google/google-java-format được xếp vào nhóm Developer Tools?
TopGit xếp google/google-java-format vào nhóm Developer Tools dựa trên GitHub topics và mô tả của repo (gắn thẻ: "formatter", "java"). Việc phân loại dựa trên metadata thật của repo, không phải đoán theo cảm tính biên tập.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về google-java-format?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về google-java-format.