エラーが出ると混乱する人へ

エラーが出ると混乱する人へ

プログラミングやってて必ずと言っていいほど出くわすのがエラー。しかも、プログラミングの約半分がそのエラーと戦う作業と言っても過言ではない。これはスキルがいくら上がっても同じ。ずっとトラブルシューティングしてるようなもん。あーだるい。いうこと聞けよな。自分の書いたプログラムが一発で動いたら未だに感動する。俺は運がいい、と。

初心者が挫折するほとんどの理由は、このエラーに対処できないことだと思う。しかも残念なことに入門書の類いはうまくいくやり方しか書いてない。なぜなら書いてる本人にすら、何が起こるかすべて把握しきれないから。だから本に書いてないエラーは起こるべくして起こる。それを初心者はどうやって乗り越えれば良いのか分からなくて、ついには諦めてしまう。もったいないぞ。

エラーが起こる条件は無数にあって、全部書きだすのは無理。だから前もって「こんなエラーが起こるかも」と覚えるのは無駄な努力だからしない方がいい。そんな受験勉強みたいなやり方は間違い。絶対やらないで。

エラーは起こった時に都度調べればいい。覚えなくていいから。全然恥ずかしくないから。本に書いてねぇじゃん!とゴミ箱に投げつけるのはもうちょっと我慢して。そういうもんやねん。

初心者を教えてると、目の前でやって見せたのにも関わらずエラーで躓くことがある。例えば、CLIで選択肢の入力を求められているのに、何も選択せずにReturnキーを押してた、とか。そんなん絶対予想出来ない。

だから、なんか上手く行かない!ってなったら、まず自分を疑って欲しい。ちゃんと指示通りにやってる?ほんまに?うそやろ?それ思い込みやで。その自信をまずは捨てて。「なんも(悪いこと)してないのに動かなくなった」って言う人ほど灯台下暗しだ。

なんか意味わからん英語が出る。何言ってるかわからん。まるで死の宣告みたいだ。エラーメッセージってほんまそれ。コンピューターは冷徹に主人にそれを突きつけてくる。ERROR!の文字を見ただけで蕁麻疹が出そうになる。コーヒーを何杯飲んでも音楽をどれだけ聴いてもエラーへの嫌悪感は拭えない。

しかし諦めないで読んでみて欲しい。何かを訴えかけているはず。どのコードが悪いのか言ってくれてるかもしれない。わけワカメ?じゃあとりあえずググってみよう。同じボートに乗り合わせた人はほぼ間違いなくいて、先に解決して待ってくれてるから。

もし動いてたものが動かなくなったら、その大半は直前の変更点が原因だ。だから初心者は尚一層、石橋を叩いて渡ってほしい。コードを一行変更するごとにプログラムを走らせて欲しい。30行ぐらい変更した後に動かしてみてエラーが起こると、何が悪いのか検討もつかなくなるから。

どこが悪いか分からないなら、ちょっとずつ変更点をもとに戻しながら何度も実行してみる。これは自分もよくやる手法。すると、どっかの時点でエラーが消える。お前か!となる。

変更点を全部もとに戻してもまだエラーが起こるなら、コードとは別の変更点が原因の可能性が高い。例えば、PCを再起動させたせいでサーバが起動してなかったとか。ツールのバージョンを上げたとか。なんか全然別のファイルをいじってたとか。あるある。よくあるよ。

「俺は一体なにをしているんだ」と自問する。これはまじで有効。一旦落ち着いて考えるということ。

例えば、打っていたコマンドを実行する「場所」が間違っていたなんて事はよくある。場所とは、パスだったりサーバだったり。そのコマンドが参照している設定ファイルと、自分の編集している設定ファイルが違うなんてこともよくある。だから、「自分のやっている事は正しい」という思い込みを常に捨てる必要がある。

なんか仕事が遅い人って、ずっと同じエラーと戦ってるイメージがある。そういう人って、おかしいところが直せないのではなくて、そもそもおかしいところをおかしいと思っていない。そういうハマり体質の人はこの記事で書いたことを参考にしてみて欲しい。

みんなエラーが苦手だ。だからpower-assertが流行ったりするんだね。

Read more

ノート駆動AIコーディング術の提案

ノート駆動AIコーディング術の提案

どうもTAKUYAです。みなさんはAIエージェントを普段のコーディングで活用されていますか。ちょっと面白いワークフローを思いついたのでシェアします。それは、ノート駆動のエージェンティック・コーディング・ワークフローです。最近Claude Codeのプランモードを使っていたら、ターミナル内で生成されたプランを読むのが辛かったんです。それで、じゃあMarkdownノートアプリであるInkdropをプランの保存先バックエンドとして使えば解決するんじゃないかと思って、 試してみました。こちらがそのデモです(英語): こちらがClaude Codeの設定ファイル群です: GitHub - inkdropapp/note-driven-agentic-coding-workflow at devas.lifeComplete Claude Code configuration collection - agents, skills, hooks, commands, rules, MCPs. Battle-tested configs from an Anthropic hackathon w

By Takuya Matsuyama
2025年個人開発活動の振り返り

2025年個人開発活動の振り返り

どうもTAKUYAです。もう1月も半ばに差し掛かっているけど、2025年の自分の活動の振り返りをしたい。去年を一言で言うなら、本厄を満喫した年だった。 厄年とは、人生の節目にあたって、体調不良や災難が起こりやすいと経験的に言われる年齢のこと。数え年で42歳、確かにもう若さに任せた事は出来ないなと痛感した年だった。(ところであなたの国ではこのような年はありますか?) 夏に体調を崩して2~3ヶ月動けなくなった 暖かくなり花粉が飛び出した頃に、持病のアトピーが悪化しだして、まともに生活出来なくなってしまった。酷さで言うと、2019年に脱ステした時と同じぐらい。 脱ステに無事成功したから、この地獄は二度と味わうことはないだろうと高を括っていたが、まさか7年後にまた味わうとは思わなかった。当時の独身時代と違い、妻も子供もいる中で、周りに多大な迷惑をかける事となった。夏の子供との思い出が全く無い。悲しい。 現在はQoLもほとんど元の状態まで復活できた。写真を撮って症状の変化を記録したので、機会があればシェアしたい。食事療法など色々試したが、結局歩くのが一番自分に効いた。それ以来、一日一万歩

By Takuya Matsuyama
書いて、歩け!なぜノートアプリはシンプルで充分なのか

書いて、歩け!なぜノートアプリはシンプルで充分なのか

どうもTAKUYAです。今回はノートやメモから新しい発想を生むための考え方についてシェアします。 自分はシンプルさをウリにした開発者向けのMarkdownアプリInkdropを作っています。なので、どうしても「ノートアプリの作者」としてのポジショントークが含まれてしまいますが、逆に言えば、「ノートアプリを約10年間作り続けてきた人間が、どうやってアイデアを生み出しているのか」 という実際的な体験談として読んでもらえれば幸いです。 結論から言うと、僕は「アプリ上でノート同士を連携させる必要はない。繋げるのはあなたの脳だ」と考えています。本稿では、ノートアプリの機能に溺れずユニークなアイデアを考え出すために僕が実践している事をシェアします。 TL;DR * ノート整理に時間をかけるな。グループ化で充分だ * すごい人はアイデアが「降りてくる」のを待つ * プログラミング × 料理動画 という有機的な掛け合わせ * ノートは「忘れる」ために書く * 歩け! ノート整理に時間をかけるな。グループ化で充分だ 巷ではZettelkastenなどが流行っているようですね。これ

By Takuya Matsuyama
貫禄を捨てて愛嬌で生き延びろ!40代オッサンの生存戦略

貫禄を捨てて愛嬌で生き延びろ!40代オッサンの生存戦略

どうもTAKUYAです。 つい先週(11月19日)に誕生日を迎え、41歳になりました。40代と言うのは若い頃には想像もしなかった年代で、どう生きれば良いのかというイメージがあまり具体的に湧かない、曖昧な年齢ではないでしょうか?自分の父親を想像するも、日中はいつも仕事でいなかったのであまり参考になりません。 自分は個人開発で生計を立てていて20代、30代で積み上げて来たものが上手く実を結んだおかげで今の生活があります。育児にも、いわゆるサラリーマンよりかは柔軟に参加できていて、子供との時間も沢山取れています。ママ友も出来ました(迷惑かけっぱなしですが)。 本記事では、そんなライフスタイルを送る自分が40代で大事にしたいことについて書きたいと思います。タイトルにもある通り、結論から言うとそれは「愛嬌」だと思います。以下、中年男性の愛嬌の重要性について説明します。 TL;DR * 「貫禄が出てきたね」と言われたら注意 * 笑顔を作れ。オッサンがムスッとしてたら普通に怖い * 謙虚に振る舞え。実績を積むと周りが萎縮する * ギャップ萌えを活用しろ 「貫禄が出てきたね」と言わ

By Takuya Matsuyama