【現役エンジニア直伝】プログラミングで詰まった時に問題を解決するためのググりかた

どうも、ウェブ系ウシジマくんです。

さて、プログラミングをやっている時に、想定した挙動にならなかったり、エラーになったりして詰まることってありますよね。

その際、Googleで検索すると思いますが、一向に問題解決できない時ってありませんか？

Twitterで次のようなツイートをしたところ、多くの方に反応をいただいたので、同じように困っている方が多いようですね。

ライブラリなどを使っていて、挙動を知りたくなったら、何時間もかけて日本語の解説記事を探すよりも、
✅公式リファレンス
✅Issue
✅ソースコード
を追っていくのが一番手っ取り早い。
「コードがムズい」と思うかもしれませんが、そんな時こそ認識あっているか有識者へ質問してみると良いかと。
— ウェブ系ウシジマくん@リモート専門エンジニア (@web_ushizima) July 26, 2019

ということで、今回は「プログラミングで詰まった時に問題を解決するためのググりかた」をテーマを取り上げたいと思います。

ググる時にはヒットしやすいキーワードに選定する
公式リファレンスを参考にする
公式リポジトリのIssueを確認する
GitHubの検索スペースを使う
まとめ

ググる時にはヒットしやすいキーワードに選定する

ググってもうまくエラーが解決できない時の要因として、エラーメッセージをそのまま検索していることがあげられます。

特に、検索キーワードにファイルパスなども含めてしまっている場合は、その傾向が顕著ですね。

というのも、エラーメッセージと共に表示されるファイルパスというのは、基本的に実行環境ごとにユニークなはずなんですよね。

では、どうしたらいいのか。

具体的な例をあげて説明しましょう。

例えば、railsのActiveRecordを使ってDBを作成するコマンドbundle exec rails db:createを実行した際に、次のようなエラーが出たとしましょう。

Access denied for user 'root'@'localhost' (using password: YES)
Couldn't create 'hello_world_rails_development' database. Please check your configuration.
rails aborted!
Mysql2::Error::ConnectionError: Access denied for user 'root'@'localhost' (using password: YES)
/Users/web_ushijima/git/hello_world_rails/vender/bundle/ruby/2.5.0/gems/mysql2-0.5.2/lib/mysql2/client.rb:90:in `connect'

この時、検索するキーワードとして、

> Couldn’t create ‘hello_world_rails_development’ database.

この辺りで検索しようとしても、なかなかドンピシャな記事にたどり着くのは難しいでしょう。

これは、 'hello_world_rails_development' の部分で記載されているデータベース名というのは、それこそ実行環境ごとに違うからなんですよね。

それよりも、

> rails Mysql2 Error Couldn’t create database

このような形で、どの実行環境でも必ず出てくる汎用的なキーワードで検索した方が、より問題解消に役立つページにヒットしやすいんです。

なぜなら、これらのキーワードは、フレームワークやプログラミング言語にエラーメッセージとして実装されているから。

def create(*arguments)
        configuration = arguments.first
        class_for_adapter(configuration["adapter"]).new(*arguments).create
        $stdout.puts "Created database '#{configuration['database']}'" if verbose?
      rescue DatabaseAlreadyExists
        $stderr.puts "Database '#{configuration['database']}' already exists" if verbose?
      rescue Exception => error
        $stderr.puts error
        $stderr.puts "Couldn't create '#{configuration['database']}' database. Please check your configuration."
        raise
end

上記はrailsのactive_record内で定義されているタスクランナーのdatabase_tasksのコードです。

エラーメッセージとして、

> “Couldn’t create ‘#{configuration[‘database’]}’ database. Please check your configuration.”

この文字列を返そうとしているので、実行環境問わず表示されるメッセージになっています。

このように、フレームワークやプログラミング言語固有のキーワードでググるのが、効率よく問題解消する時のコツですね。