Nacos

Code Style

Nacos code style Comply with Alibaba Java Coding Guidelines and code style file customized by Nacos community.

Nacos的编码规范遵从于《阿里巴巴JAVA开发规约》和社区制定的Nacos代码风格文件。

Nacos Code Style file is style/nacos-code-style-for-idea.xml in source code. Developers can import it to Idea IDE and reformat code by IDE.

Nacos代码风格文件在源代码下的style/nacos-code-style-for-idea.xml文件中，开发者可以将其导入到Idea IDE中，并让IDE帮助您格式化代码。

Preferences/Settings --> Editor --> Code Style --> Schema --> Import Schema --> IntelliJ IDEA code style XML

Volunteer wanted.

待补充。

It is not necessary to install, if you want to find a problem when you are coding.

不是必须安装，如果你需要在开发的时候实时发现问题的话，你需要安装。

Preferences/Settings --> Other Settings --> Checkstyle OR Preferences/Settings --> Tools --> Checkstyle
Set checkstyle version at least 11.0.0 (required for Java 17 support) and scan scope All resource(including tests) in checkstyle plugin.
Import style/NacosCheckStyle.xml to checkstyle plugin.
Scan and check your modified code by plugin.

Preferences/Settings --> Other Settings --> Checkstyle 或者 Preferences/Settings --> Tools --> Checkstyle
在checkstyle插件中设置checkstyle版本至少为11.0.0（Java 17支持所需），并将扫描作用域设置为All resource(including tests)
导入源代码下style/NacosCheckStyle.xml文件到checkstyle插件。
用checkstyle插件扫描你修改的代码。

Preferences/Settings --> Plugins search "SpotBugs" and install.
Run SpotBugs analysis on your modified code to catch potential bugs before submitting.

Volunteer wanted.

待补充。

Nacos uses Spotless Maven Plugin with Eclipse JDT Formatter for automated Java code formatting. The formatter configuration is at nacos-eclipse-formatter.xml.

bash

# Auto-format all Java files
mvn spotless:apply

# Check formatting (same as CI, does not modify files)
mvn spotless:check

Generated and third-party code is excluded from formatting: