问题标签 [code-readability]

我有一段代码如下所示：

但是，我的异常没有显示它来自哪个特定调用。堆栈跟踪也只显示从函数调用内部调用的另一个类的详细信息。

包装它的另一种方法是：

虽然我认为它的可读性比以前的版本要低得多。

是否有包装函数调用或传递异常的模式，以便我以后可以在保持代码可读性的同时看到它们的来源？

在 C++ 中，函数需要在调用之前声明。这可以通过函数签名来解决，但在大多数情况下，这在较新的编程语言、C#、Python、ETC 中不再需要。

但是，在阅读其他人的代码以及必须在类中构造函数时，我发现我怀念 C++ 中存在的一致性。

在保持可读性和对代码结构的理解的同时声明/订购函数存在哪些模式？

编辑 1

这是一个粗略的例子。

对比

编辑 2

无论编辑器如何，这都是编写代码的指南。较新的编辑器具有出色的“去定义”功能，书签也可以帮助解决这个问题。但是我对独立于编辑器的模式感兴趣。

每个人都知道更具可读性的代码的优点。因此，为了使我的代码更具可读性，我通常会在该类的实现文件中包含注释的类声明。
这样我就不必浏览各种包含目录来进行定义。
那么，这是一个好的做法还是只是过度记录？
如果有一些标准技术，请告诉我。
编辑：
有没有办法从 Vim 中的实现迁移到类声明？
除了在新缓冲区中打开它。

谢谢

我正在尝试在这里清理这种极其丑陋的方法，这迫切需要重构，但我不确定哪种结构最能做到这一点（即案例陈述，或者只是一个精心格式化的if then陈述）

乍一看，这似乎是一个放置几个很好when的 's 的 case 语句的理想场所，但我的理解是 case 语句只能用于单个变量，而不是两个，以及各种 irb 的摆弄使用散列或数组来尝试这些语句在这里也没有得到太多启示。

你会怎么做？在检查这样的多个布尔值时，Ruby 中是否有任何常见的技巧来避免这样的代码？

在使用 WPF 时，我在 XAML 和设计器之间切换。这会导致每个元素上的属性以不同的方式排序，并使代码更难阅读，除非我手动重新排序所有内容。

有没有更简单的方法来做到这一点？

尽管我确实了解 CSS 和 HTML，但我是一个完整的编程初学者。

我想学习Python。我下载了很多源代码，但文件的数量和复杂性确实让我感到困惑。我不知道从哪里开始。我应该寻找一个特定的顺序吗？

谢谢。

编辑：对不起，伙计们，我忘了提到我已经有了在线教程和几本书。我基本上不太了解如何“拆解”和理解复杂的源代码，以便掌握编程技术和概念。

EDIT2：感谢您的快速评论，伙计们。对此，我真的非常感激。这个网站很棒。

相对于：

和

相对于：

我认为 if(false == ... 版本更具可读性。您同意，还是您可以提出另一个技巧？它会一样快吗？谢谢。

这就是我不喜欢 !x 的原因：

以下似乎更好：

我想知道我应该把 & 放在哪里。

我正在寻找一种适用于 Windows 的工具来重新格式化我的代码库中的一些 C++ 代码。从本质上讲，我有一些我不久前写的想要使用的代码，但它与我在最近的项目中使用的风格不匹配。

以标准方式重新格式化 C++ 代码的最佳方法是什么？

比利3

我目前正在写一份正式的研究报告，我将在这份报告中包含代码。

问题：在研究报告中显示代码是否有一种可接受的方式？我在考虑字体、间距等方面，以及代码是否应该显示在文档中或附录中。

代码将是 JavaScript 和 PHP。代码的任何部分都不会超过 25 行（所以它们只是片段）。大约会有六个片段。每个片段都会有几段解释代码中发生的事情，并讨论其优缺点。

我与将向其提交报告的机构没有联系，他们也没有发布关于如何格式化代码的指南（请不要质疑这些点）。