Thụt lề python so với dấu ngoặc nhọn

Bạn đang đọc ấn bản đầu tiên của Advanced R;

Phong cách mã hóa tốt giống như sử dụng đúng dấu câu. Bạn có thể quản lý mà không cần nó, nhưng nó chắc chắn giúp mọi thứ dễ đọc hơn. Cũng giống như các kiểu chấm câu, có nhiều biến thể có thể xảy ra. Hướng dẫn sau đây mô tả phong cách mà tôi sử dụng [trong cuốn sách này và những nơi khác]. Nó dựa trên hướng dẫn kiểu R của Google, với một vài chỉnh sửa. Bạn không nhất thiết phải sử dụng phong cách của tôi, nhưng bạn thực sự nên sử dụng một phong cách nhất quán

Phong cách tốt rất quan trọng bởi vì mặc dù mã của bạn chỉ có một tác giả nhưng nó thường sẽ có nhiều người đọc. Điều này đặc biệt đúng khi bạn đang viết mã với người khác. Trong trường hợp đó, bạn nên thống nhất trước về một phong cách chung. Vì không có phong cách nào hoàn toàn tốt hơn phong cách nào nên làm việc với những người khác có thể đồng nghĩa với việc bạn sẽ cần phải hy sinh một số khía cạnh ưa thích trong phong cách của mình.

Gói formatR, của Yihui Xie, giúp dọn dẹp mã định dạng kém dễ dàng hơn. Nó không thể làm mọi thứ, nhưng nó có thể nhanh chóng đưa mã của bạn từ tệ đến khá tốt. Đảm bảo đọc phần giới thiệu trước khi sử dụng

Ký hiệu và đặt tên

Tên tệp

Tên tệp phải có nghĩa và kết thúc bằng

0-download.R
1-parse.R
2-explore.R

3

# Good
fit-models.R
utility-functions.R

# Bad
foo.r
stuff.r

Nếu các tệp cần được chạy theo trình tự, hãy thêm tiền tố vào các số

0-download.R
1-parse.R
2-explore.R

Tên đối tượng

“Chỉ có hai điều khó khăn trong Khoa học Máy tính. vô hiệu hóa bộ đệm và đặt tên cho mọi thứ. ”

— Phil Karlton

Tên biến và hàm nên viết thường. Sử dụng dấu gạch dưới [

0-download.R
1-parse.R
2-explore.R

4] để phân tách các từ trong tên. Nói chung, tên biến nên là danh từ và tên hàm nên là động từ. Phấn đấu cho những cái tên ngắn gọn và có ý nghĩa [điều này không dễ dàng. ]

# Good
day_one
day_1

# Bad
first_day_of_the_month
DayOne
dayone
djm1

Nếu có thể, tránh sử dụng tên của các hàm và biến hiện có. Làm như vậy sẽ gây nhầm lẫn cho người đọc mã của bạn

# Bad
T