2018-07-21 00:27:23 +08:00
|
|
|
|
# Nacos
|
|
|
|
|
|
2020-06-16 20:16:58 +08:00
|
|
|
|
## Code Style
|
|
|
|
|
Nacos code style Comply with Alibaba Java Coding Guidelines and code style file customized by Nacos community.
|
2018-07-21 00:27:23 +08:00
|
|
|
|
|
2020-06-16 20:16:58 +08:00
|
|
|
|
Nacos的编码规范遵从于《阿里巴巴JAVA开发规约》和社区制定的Nacos代码风格文件。
|
2018-07-21 00:27:23 +08:00
|
|
|
|
|
2020-06-16 20:16:58 +08:00
|
|
|
|
### Guidelines
|
2018-07-21 00:27:23 +08:00
|
|
|
|
[Alibaba-Java-Coding-Guidelines](https://alibaba.github.io/Alibaba-Java-Coding-Guidelines/)
|
|
|
|
|
|
2019-07-04 22:15:34 +08:00
|
|
|
|
[阿里巴巴JAVA开发规约](https://github.com/alibaba/p3c/blob/master/%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4Java%E5%BC%80%E5%8F%91%E6%89%8B%E5%86%8C%EF%BC%88%E5%8D%8E%E5%B1%B1%E7%89%88%EF%BC%89.pdf)
|
2018-07-21 00:27:23 +08:00
|
|
|
|
|
2020-06-17 10:03:55 +08:00
|
|
|
|
[community issue](https://github.com/alibaba/nacos/issues/2992)
|
|
|
|
|
|
|
|
|
|
## Nacos Code Style File
|
|
|
|
|
|
|
|
|
|
### Idea IDE
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
2020-06-17 10:03:55 +08:00
|
|
|
|
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.
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
2020-10-30 16:53:31 +08:00
|
|
|
|
Nacos代码风格文件在源代码下的`style/nacos-code-style-for-idea.xml`文件中,开发者可以将其导入到Idea IDE中,并让IDE帮助您格式化代码。
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
2020-06-17 10:03:55 +08:00
|
|
|
|
#### Import Way/导入方式
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
2020-06-17 10:03:55 +08:00
|
|
|
|
```
|
|
|
|
|
Preferences/Settings --> Editor --> Code Style --> Schema --> Import Schema --> IntelliJ IDEA code style XML
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### eclipse IDE
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
|
|
|
|
Volunteer wanted.
|
|
|
|
|
|
|
|
|
|
待补充。
|
2018-07-21 00:27:23 +08:00
|
|
|
|
|
|
|
|
|
## IDE Plugin Install(not necessary)
|
|
|
|
|
|
|
|
|
|
*It is not necessary to install, if you want to find a problem when you are coding.*
|
|
|
|
|
|
|
|
|
|
*不是必须安装,如果你需要在开发的时候实时发现问题的话,你需要安装。*
|
|
|
|
|
|
|
|
|
|
### idea IDE
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
|
|
|
|
#### p3c
|
2018-07-21 00:27:23 +08:00
|
|
|
|
[p3c-idea-plugin-install](https://github.com/alibaba/p3c/blob/master/idea-plugin/README.md)
|
|
|
|
|
|
|
|
|
|
[p3c插件idea IDE上安装方法](https://github.com/alibaba/p3c/blob/master/idea-plugin/README_cn.md)
|
|
|
|
|
|
2020-06-16 20:16:58 +08:00
|
|
|
|
#### checkstyle
|
|
|
|
|
[chechstyle-idea-install](https://plugins.jetbrains.com/plugin/1065-checkstyle-idea)
|
|
|
|
|
|
2020-06-23 09:45:49 +08:00
|
|
|
|
1. `Preferences/Settings --> Other Settings --> Checkstyle` OR `Preferences/Settings --> Tools --> Checkstyle`
|
2020-06-17 10:03:55 +08:00
|
|
|
|
2. Set checkstyle version at least 8.30 and scan scope `All resource(including tests)` in checkstyle plugin.
|
|
|
|
|
3. Import `style/NacosCheckStyle.xml` to checkstyle plugin.
|
|
|
|
|
4. Scan and check your modified code by plugin.
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
|
|
|
|
[chechstyle插件idea安装](https://plugins.jetbrains.com/plugin/1065-checkstyle-idea)
|
|
|
|
|
|
2020-06-23 09:45:49 +08:00
|
|
|
|
1. `Preferences/Settings --> Other Settings --> Checkstyle` 或者 `Preferences/Settings --> Tools --> Checkstyle`
|
2020-06-17 10:03:55 +08:00
|
|
|
|
2. 在checkstyle插件中设置checkstyle版本至少为8.30,并将扫描作用域设置为`All resource(including tests)`
|
|
|
|
|
3. 导入源代码下`style/NacosCheckStyle.xml`文件到checkstyle插件。
|
|
|
|
|
4. 用checkstyle插件扫描你修改的代码。
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
2018-07-21 00:27:23 +08:00
|
|
|
|
### eclipse IDE
|
2020-06-16 20:16:58 +08:00
|
|
|
|
|
|
|
|
|
#### p3c
|
|
|
|
|
|
2018-07-21 00:27:23 +08:00
|
|
|
|
[p3c-eclipse-plugin-install](https://github.com/alibaba/p3c/blob/master/eclipse-plugin/README.md)
|
|
|
|
|
|
|
|
|
|
[p3c插件eclipse IDE上安装方法](https://github.com/alibaba/p3c/blob/master/eclipse-plugin/README_cn.md)
|
|
|
|
|
|
2020-06-16 20:16:58 +08:00
|
|
|
|
#### checkstyle
|
|
|
|
|
|
|
|
|
|
Volunteer wanted.
|
|
|
|
|
|
|
|
|
|
待补充。
|
|
|
|
|
|
|
|
|
|
### Acknowledgement [Alibaba p3c](https://github.com/alibaba/p3c)
|