[程序员英语口语][Clean code]Chapter1-2 Why good names matter_程序员日常讨论英语口语训练问题-优快云博客

本文链接：https://blog.youkuaiyun.com/lingfy1234/article/details/122570278

Clean code

chapter1 naming

1.2 Why good names matter

When it comes to naming things, there is one simple overarching rule, and that would be names should be meaningful.

This really is all, this is the core idea whenever you name something no matter if that’s a variable or a function or a class, the name should be meaningful. It’s should transport what’s stored in a variable, or what a function or method does without having to look at the code inside of that function or method, or without exploring the value stored in a variable.

For example consider this code snippet. It’s not a lot of lines, but it’s really no clear at all what’s going on there.

What are we doing there. What does process do and what is the value of login. Is it the function for which existence we check? Is it a boolean value? Is it a string? an error code? We don’t know at all.

And now consider this alternative. It’s the same code, but it’s way clearer, It’s now obvious that we are creating a user

Which we are then saving? maybe to file or to a database, this might not matter to us, but we are saving the user.

And we got isLogin instead of login, making it clear that this very likely holds the result of checking whether that user is logged in or not.

So a boolean value , true or false. This is now very readably, and very easy to understand, even though it’s the same number of lines. The only difference is that now we have meaningful names.

So picking good names in your code really matters, If we have well-named things, variable and so on. In our code, we allow our readers and people reading our code, to understand that code without going through all the details, withoug diving into it in detail. Consider this examples. In all three example.

It’s pretty clear what this code does, even though we don’t know the details. We don’t need to dive into the rest of the code just to understand these snippets.

That’s why naming matters. Now I will emphasize right away, we will not always agree, because, obviously, there is more than one way of naming something. I will explore this rules. We can follow to come up with good names, but ultimately, you will still always have more than one option. But this here is also readable and not necessarily worse. You could definitely find arguments for either of the two names. And it’s up to you how you wanna name something. There are, however, also some names which clearly are bad.

So that by the end of the section, you have a clear understand of what makes up a good name, and then of course, It’s up to you to pick which good name you wanna go with.

Recommend:

1.when it comes to 当说到…时