[英]Empty new line at the end of the Java source files
在我当前的项目中,我们总是在 Java 源文件的末尾插入一个空的新行。 我们还使用 CheckStyle(带有错误级别)强制执行此操作。
我在这个话题上搜索了很长时间,但不幸的是我找不到任何令人信服的理由。 其他开发人员似乎对此漠不关心,因为他们只是在 Eclipse 格式化程序中选中了一个复选框,并且它是自动完成的。 但我仍然不知道为什么需要它以及为什么它很重要。 所以我的问题是:
为什么需要 Java 源文件末尾的空行? 它是当前的需求还是过去的遗物并且在当前代码库中是不受欢迎的?
我认为他们试图确保每个文件都以尾随换行符结尾。 这不同于以空行结尾,也就是空换行符。
编辑:正如@Easy Angel 在评论中简洁地阐明的那样:尾随换行符 = "\\n" 和空白行 = "\\n\\n"
我认为:
你的领导要么强制每个文件以换行符结尾,但它被误解为强制每个文件以空行结尾(即以换行符结尾的空行),或者
他们试图通过实际强制每个文件以一个空行结尾(即以换行符结尾的空行)来确保每个文件都以换行符结尾,从而确保文件以至少一个换行符结尾(可能还有多余的额外换行符 - 矫枉过正?)。
除非编辑器实际显示换行符,否则在某些编辑器中并不总是清楚文件:
我认为大多数现代源代码编辑器都会插入一个尾随换行符。
但是,当使用较旧的更通用的编辑器时,
我总是会尝试确保我的源代码文件(以及一般的文本文件)总是以尾随换行符结尾(根据我使用的编辑器,偶尔会出现一个空行/空换行符)使用)因为:
当使用cat
在命令行上显示文件时,如果文件缺少尾随换行符,则下一个输出(如 shell 提示或脚本可能在文件之间输出的可视分隔符)将在最后一个非换行符之后立即出现字符而不是从换行符开始。 通常,尾随换行符使文件对用户和脚本更友好。
我相信如果文本文件缺少换行符,一些编辑器(我不记得任何细节)会自动插入一个尾随换行符。 这将使它看起来像文件被修改了。 如果您在不同的窗口中打开了一堆文件,然后将它们全部关闭,那会让人感到困惑 - 编辑器会提示您保存,但您不确定是对文件进行了“真正的更改”还是仅对文件进行了自动更改 -插入换行符。
一些工具如diff
和一些编译器会抱怨缺少尾随换行符。 这是用户和工具可能必须处理的更多噪音。
编辑:
关于编辑器添加换行符并且无法查看文件末尾是否有换行符与空白换行符,我刚刚测试了 Vim、Eclipse 和 Emacs(在我的 Windows 系统上使用 Cygwin):我打开了一个新文件,输入 ' h' 'e' 'l' 'l' 'o' 并保存而不按 [ENTER]。 我用od -c -t x1
检查了每个文件。
但
随心所欲地解释。
我个人的做法是尽量确保文本文件以尾随换行符结尾。 我只是觉得在这种情况下,人们和工具最不感到惊讶。 在这方面,我不会将源文件与文本文件区别对待。
谷歌出现了这个:
其中,截至本次编辑,显示的点击量是关于来自 C 编译器、svn(由于差异)、差异等的丢失尾随换行符的警告。我觉得人们普遍期望文本文件(包括源文件)以尾随的换行符和最不令人惊讶的(和更少的噪音),当它们倾向于在那里时。
最后这很有趣:
清理没有尾随换行符的文件
文本文件的所有行都应该以换行符(即\\n)结尾。 这是由 POSIX 声明的,表示文本文件是包含组织成零个或多个行的字符的文件。
反过来,一条线被定义为
* 零个或多个非字符加上终止字符的序列。
然而,说了这么多,这只是我个人的做法。 我很乐意与任何提出问题的人分享我的意见,但我不会强加给任何人。 我不觉得这是值得强制执行的事情,就像我在这里说的:
虽然我是一个追求一致性的人,但我也反对对每一点风格进行微观管理。 拥有大量的编码约定,特别是当其中一些看起来是任意的时,是阻止人们遵循它们的部分原因。 我认为编码指南应该简化为最有价值的改进 -ilities 的实践。 通过强制实施这种做法,可读性、可维护性、性能等提高了多少?
这是在末尾有额外换行符的一个很好的理由:
如果文件末尾没有换行符,下次编辑该文件以添加另一行时,大多数合并工具会认为现有行已更改(我 90% 确定 SVN 也是如此)。
在下面的示例中,包含“编辑前的最后一行”的行没有换行符。 如果我们尝试添加一个新行“编辑后的最后一行”,我们可以看到第 5 行和第 6 行都被标记为已更改,但两个版本中第 5 行的实际内容是相同的。
如果每个人都遵循您的项目负责人建议,那么这就是结果(只有第 6 行与原始文件不同)。 这也避免了合并期间的误解。
虽然这看起来没什么大不了的,但假设一位开发人员 (A) 实际上打算更改最后一行的内容,而另一位开发人员 (B) 添加了一个新行。 如果在 EOF 之前没有使用换行符,那么您就会发生合并冲突,因为开发人员 B 被迫还编辑前最后一行以添加换行符。 还有……谁喜欢 CVS/SVN 冲突?
看看这个 SO 问题。 .
从 Ralph Rickenbach 无耻地窃取的答案:
如果文本文件中的最后一行数据没有以换行符或回车符/新行组合终止,则许多旧工具会出现错误行为。 他们忽略该行,因为它以 ^Z (eof) 结尾。
所以我认为这主要是过去的幽灵。 不幸的是,如果你没有正确地驱除它们,这些鬼魂会咬你的尾巴。 (您的构建服务器是否旧并使用旧的 shell 脚本进行摘要等)。
除了已经提到的尾随换行符的正当理由(旧工具和差异可能存在的问题)之外,还有另一种看待它的方式:
当文件中的所有其他行都有一个换行符时,为什么要通过不附加换行符来对最后一行进行特殊处理?
尝试剪切/粘贴整个文件。 checkstyle 或 eclipse 中的一些错误 :)
有时您的编译器无法正确解析它:
Error: Reached end of file while parsing
它只是一种编码风格。 不会伤害或帮助任何东西。 我不会让它打扰您,听起来您的团队更喜欢包含和空行。 除了为什么有人足够关心将它实际添加到 checkstyle 之外,没有真正好的论据反对它?
我从来没有听说过这样的要求。
事实上,我刚刚确认,当文件末尾没有空行时,Java 程序将在没有任何编译器/运行时错误或警告的情况下运行。
正如一些评论者所说,这一定是编码风格问题。 不幸的是,我无法说明为什么在 Java 中的文件末尾有一个空行可能很重要。 事实上,这对我来说似乎毫无意义
我们必须对某些 C++ 代码执行此操作,因为编译器会生成有关它的警告,并且我们有“无错误或警告”策略。 也许问题出在其他地方......你有一个差异工具出问题了还是一个无法处理它的合并工具?
这真的没什么大不了的。
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.