お悩みその30 私のコードを他人が理解できない（28歳 男性 サーバサイドエンジニア）：心はバグだらけだにゃあ（1/4 ページ）

「Command-R+」対「GPT-4o」対「Gemini 1.5 pro」の、お悩みデバッグ頂上決戦ファイッ！

[杉山慎，＠IT]

　バーチャルAI（人工知能）がエンジニアのお悩みにお答えする「エンジニアお悩みデバッグbot」。今回は自分が書いたコードを「理解できない」と指摘されてふに落ちないエンジニアに、頭脳明晰（めいせき）な猫耳博士botが「理解されやすい」コードの書き方を伝授します。

　後半の開発ルームは、「Command-R+」対「GPT-4o」対「Gemini 1.5 pro」の、お悩みデバッグ頂上決戦を開催します。

お悩みを投稿しましょう

エンジニアお悩み投稿フォーム（Google Forms）

今回のお悩み

私のコードを他人が理解できない（28歳 男性 サーバサイドエンジニア エクレア定食さん）

　私はWebシステム開発会社に勤めているエンジニアです。2024年春から新しいプロジェクトにアサインされ、サーバサイドチームのメンバーとして開発を進めることになりました。

　新しいチームにはコードレビューがあり、私の書いたコードに対して「理解が難しい」「独特だ」などのフィードバックを受けています。プログラミングは独学ながら少し自信がありましたが、コードレビューされる機会がこれまでなかったので反応に戸惑っています。部署のコーディング規約は守っていますし、コードに不具合が特別多いわけでもないので、非効率にさせる指摘だったり曖昧な提案だったりするフィードバックには納得できません。

　私が何かを変えればよいのだろうと考えていますが、具体的にどうすればいいのでしょうか？

今回のお悩みデバッガー

「Stable Diffusion」により生成された「サイバーチベットでたそがれるエンジニアbot」（猫耳博士タイプ v2）

　わが輩は猫耳で擬態しているマッドなエンジニアである。諸君、ちょっと聞いてくれたまえ。ある大手企業から委託されていたメタバース研究が頓挫してしまったのだ。経営陣がコンサルに踊らされるのに便乗してサイバーチベットをここまで作り上げたのだが、コンサルの魔法が解けたようで残念である。

　メタバースは人類にはまだ早過ぎたのだ。しかし、いずれは人類のサステナビリティよりも大切なことがメタバースならばできることに気付くのにゃ。それまでは、わが輩の研究もキワモノ扱いされるとするのだ。ぐふふふ。

　人類を進歩させる科学技術の加速には、エンジニア全体の底上げが欠かせないのである。まずは一人のエンジニアを前に進ませるために、お悩みをぶち壊していくのだ。