极客观点
项目管理
HarmonyOS
如果有必要添加单行注释，大家开发一般把 单行注释 放在代码行尾，还是独占一行放在代码的上方呢？还是具体情况，具体分析？是个人习惯，还是有着你的理由。希望大家讨论，我好学习学习。
行尾
var var1 = 5; // 声明并初始化变量，值为5上方
// 声明并初始化变量，值为5
var var1 = 5; 
python
java
注释写上面吧。一般来说格式化的注释，然后可以导出API。
然后就是为了让你自己看的注释，你就随便写吧。反正除了你也没人会看你的注释。文档的注释一般都在头部。随便写的注释感觉没什么用
注释格式：
1、单行(single-line)注释：//……
2、块(block)注释：/*……*/
3、文档注释：/**……*/
4、javadoc 注释标签语法
从个人的项目经验来看，情况如下使用比较整洁：
1、变量一般用单行注解，放在行尾，若变量或注解太长，也可放上方，若注解太长，就改用块注释，根据情况而定;
SAXReader reader = new SAXReader();//创建SAXReader
//获取<List>根标签下的所有emp标签
List<Element>elements = root.elements();
/*
* Element提供了获取中间文本信息的方法：
* String getText()
* String getTextTrim()
*/
String name = nameEle.getText();
2、调用方法一般用块注解，放在上方;
/* 读取XML文件 */
Document doc = xmlFileReader();
个人认为 关于注释 要有三个优先级： 项目要求规范为最高级，如果项目没有要求，那就按照官方标准，如果没有官方标准，那就按自己的标准。。 对于自己的标准，引用上面一个回答说的：“不要为了注释而注释”，注释的目的是让复杂的代码清晰易懂
至于单行注释写在上面好还是写在下面好，都没关系，我一般注释都是这样：
// XXX功能 start
...
do {
xxxxx...
} while(x...);
...
// XXX功能 end
说实在虽然放后面比较好看注释，但用起来有时候很纠结，特别是如果想在数组元素后面加注释的时候，在加了注释之后，发现要加一个新元素的时候，需要再去添加,。
栗子：
$test = [
a, //a
b //b，如果需要在后面添加一个元素，需要补上,号，虽然可以在最后元素加上,不报错，但是对于强迫症来讲，不喜欢多余的,号
]
推荐问题
扁平化数组转换成树形?
背景：需要将扁平化数组转换成树形数组。比如原始数组如下： {代码...} 期望转换后的数据 {代码...}8 回答4.8k 阅读✓ 已解决
如何避免在Java中调用空引用对象的属性或方法时抛出NullPointerException?
当试图访问一个空引用对象的属性或调用空引用对象的方法时，会抛出 NullPointer 异常。通过下面的代码可以复现出问题。 {代码...}3 回答2.6k 阅读✓ 已解决
省市区街道数据在哪里可以下载？
省市区街道数据在哪里可以下载？6 回答3.5k 阅读✓ 已解决
Redis Hash结构存储Long取出为Integer原因及解决方案？
Redis库使用的是spring-boot-data-redis,Redis的Hash结构存储Long数字类型，但取出来的是Integer，不用Hash直接存，取的就是Long，这是为什么？有办法Hash取的也是Long吗3 回答4.1k 阅读✓ 已解决
两个promise问题？
第一个问题，这个为什么先输出3后输出2呢 {代码...} 第二个问题，这个为什么会交错输出呢，142536 {代码...} promise小白一枚，上述两个疑问，希望能得到详细的解答5 回答2.9k 阅读✓ 已解决
Vue项目一个报错无法找到原因?
排查了好久实在没有找到哪儿出了问题，时不时弹出来，编译结果又是正常的，尝试排查了好久但是一直没有办法排查出来，有遇到过这种报错的同学吗？或者有没有同学提供一种排查思路，因为我真的搞懵逼了。哈哈哈。5 回答6.4k 阅读✓ 已解决
有一种算法 存在返回真，不存在返回假的高性能算法，我忘记是什么了?
与哈希桶齐名比如判断用户有没有被拉黑 这个黑名单有几百万之多3 回答3.1k 阅读✓ 已解决
宣传栏
一般情况下，个人的习惯是：
1、变量声明或初始化，放在右方
2、简短代码块声明放在上方
3、注释过长使用多行注释，并放在上方
重点是，不要为了注释而注释，变量、函数等命名规范了，代码能清晰看懂就尽量往这个方向努力。毕竟有 “代码之美”，而未曾听说有 “注释之美”。