正しいプログラムは綺麗なコードに宿る

正しいプログラムは

綺麗なコードに宿る

A good program resides in clean code.

pixiv Inc.

USAMI Kenta

北海道LT大会2022-04-15

お前誰よ

• うさみけんた (@tadsan) / Zonu.EXE / にゃんだーすわん
• ピクシブ株式会社 pixiv事業本部 エンジニア
• 最近はピクシブ百科事典(dic.pixiv.net)を開発しています
• Emacs Lisper, PHPer
• Emacs PHP Modeを開発しています (2017年-)
• プログラミング言語にちょっとこだわりのある素人

お前誰よ (地元向け)

• 砂川(1990-2007) → 宮の沢(2007-2011) → 代々木(2012-)
• 北海道工業大学 (えっ、北科大なにそれ知らん)
• 2011年頃にPython札幌勉強会とかのコミュニティをやっていました
• PHPカンファレンス北海道があれば帰省する生活 (2016, 2019)
• 札幌Ruby会議2012スタッフ、札幌市中央区Ruby会議LT

ふだんはEmacsとかPHPとかやってます

さて

綺麗なコード書いてますか？

コードの乱れは心の乱れ

正しいプログラムは綺麗なコードに宿る

綺麗なコードがモダーンなコード

美しいコードを書くのは靴を脱いで揃えるのと同じ

きたないコードは争いを生む

さあ美しいコードを書きましょう…

そう思いませんか？

どうやってコードをインデントする？

https://www.emacswiki.org/pics/static/TabsSpacesBoth.png より

均整でないソースコードの弊害

• チーム内での認知的な摩擦
• 同じリポジトリ内でも「ナワバリ」によってフォーマットの慣習が違う(!)
• コードレビューで「ここにスペースを入れてください」「ここで改行してくださ

い」などの不毛すぎる指摘をする羽目に…

• 「レビュー対応」というコードスタイルを直すだけの最悪のコミットが履歴に積

まれる (そういう些細な変更はfixupで直して…という意見はある)

誰がコードを書いても同じスタイルにしたい

Code Formatterコードスタイルを整形するツールの総称

フォーマッター導入待ったなし

退屈なことは機械にやらせよう

• ツールを呼び出すとフォーマッタが全てのコードを整形してくれる
• 人間が細かいところに気をつけながらコーディングしなくていい
• 最悪、人間がコードフォーマットをまったく把握してなくてもいい
• コミットする前にフォーマッターをかけてくれることだけ徹底してくれれば

それでだ

モダーンな言語の定義

言語標準のフォーマッターがある

go fmt dart format rustfmt

われらが最新最高言語PHPはどうだ

ただ普及してるフォーマッターはある

PHP-CS-Fixer PHP_CodeSiffer

＿人人人人人人＿＞ 二つある ＜‾Y^Y^Y^Y^Y‾

語ると長いが…設計思想の違いがある

まじめなプロジェクトではどちらかを選んで使う

で、あんたはどっち派？

どうやってコードをインデントする？

CS-Fixer CodeSniffer

両方

もちつけ

tadsan

https://www.emacswiki.org/pics/static/TabsSpacesBoth.png より

PHPについてはそのうちどこかで

続きはWebで