我的“代码示例”应该是什么样子？

Question

我刚刚进行了一次很好的电话面试(对于一个与CakePHP相关的职位来说，并不是说它对这个问题特别重要)。面试官似乎对我的简历和性格印象深刻。最后，他让我发电子邮件给他一个来自我现有工作项目的代码示例，“为了检查你不是一个秘密的糟糕的程序员，哈哈！”

我并不太担心我的代码不能独立运行，但我是一个中级程序员，而不是专家。我应该确保我的代码样本不掉进哪些明显的陷阱，以防它们将我排除在现场？第二，这可能是问题的更难回答的部分，一个代码示例中的哪些特性会如此令人印象深刻，以至于它们会立即使您更倾向于程序员？

欢迎所有的想法或建议！

Answer 1

在我找工作的时候，我用几种不同的语言解决了一堆ACM编程竞赛问题，并将这些问题作为代码样本使用。我认为他们做了很好的代码示例，因为：

• 他们解决了具有挑战性的问题。
• 这个问题不需要大量的上下文，而且很容易得到问题。
• 编写的代码不存在任何与其相关的IP风险。
• 每个问题都可以合理地存在于单个文件中，而且通常不会太长，因此任何人都应该很容易编译和测试您的解决方案，并且可以使用来自问题的测试数据。
• 显示您可以将一个复杂的问题分解成较小的部分。
• 如果有人问您解决方案的任何方面是如何工作的，这给您提供了一个很好的机会来证明您知道您在说什么，特别是如果它已经有很多年的历史了，但是您可以很快地破译正在发生的事情。

然后，您创建的代码应该清晰、一致、易于阅读和易于理解。

最后：

• 解决这些问题是值得的，也是很好的实践。

Answer 2

• 它应该在最高的严格级别上编译/解释错误和警告。
• 它不应该是你每天写的样板代码。让它变得独特和有趣，所以很明显你没有复制/粘贴它。
• 它应该有一些有趣的设计决策，并附有说明如何/为什么做出这些决定的注释。
• 目标不超过2-3页打印出来.
• 应该是你申请的语言。
• 当我第一次读它的时候，它不应该让我的大脑受伤。让朋友看一看，或张贴在codereview上。

Answer 3

另外，要非常小心，这不是来自你当前雇主的代码(他们拥有它，你不拥有它，我保证他们不会喜欢你分享它)。拿出你为之骄傲的东西，自己重新做一次，使其不再是雇主特有的(去掉对数据库表或服务器名等的任何引用)。无论您做什么，都不会提交错误的代码，或者代码类型的错误技术(我可能会拒绝提交游标的人，因为基于集合的操作会更简单，并且在查看SQL代码时执行得更好。)对于其他语言，也有类似的技术来解决一个相对罕见的问题，这些问题可以用于其他更常见的问题，但并不是解决其他问题的最佳选择。这句话说得通吗？)