Pythonにおけるunicode decode errorに関する回避方法を現役エンジニアが解説【初心者向け】
初心者向けにPythonにおけるunicode decode errorに関する回避方法について現役エンジニアが解説しています。ファイルの文字コードと、読み込みの際に指定している文字コードの種類が違うために、文字列に変換することが出来ない場合に生じるエラーです。エラーが出ないようにする方法を解説します。
テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日 調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名 調査手法:インターネット調査
監修してくれたメンター
nakamoto
Pythonにおけるunicode decode errorに関する回避方法について、テックアカデミーのメンター(現役エンジニア)が実際のコードを使用して初心者向けに解説します。
Pythonにおけるunicode decode errorを知っておくことで、実務でエラーが発生したときに対応できるようになります。
目次
そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

今回は、Pythonに関する内容だね!

どういう内容でしょうか?

Pythonにおけるunicode decode errorに関する回避方法について詳しく説明していくね!

お願いします!
この記事では、Pythonでファイルを読み込もうとしたときに表示されることのある、UnicodeDecodeErrorに対する対処方法について説明します。
文字コードとは?
ファイル読み込み時のUnicodeDecodeErrorを回避するために、文字コードの解説をします。
文字コードというのは、それぞれの文字に割り振られた識別用のコードのことで、コンピュータで文字を表現するときに必要になってきます。
コンピュータやファイルの種類によって文字コードは変わってくるので、ファイルの読み込みや、ファイルの保存の際に意識しておく必要があります。
文字コードの種類には、UnicodeやUTF-8、ASCIIやシフトJISなどがあります。
次の文字コード表はWikipediaに有る資料の例です。
decode errorとは?
decode errorというのは、文字コードを文字列に変換することができないことで生じるエラーです。
例えば次のような、指定文字コードと読み込み文字コードが異なる場合に発生します。
- データをPythonのstr型の文字列として読み込みたい場合に、指定文字コードと読み込み文字コードの種類が違う
- 文字列の結合などのデータ加工がしたい場合などに、指定文字コードと読み込み文字コードの種類が違う
Pythonで文字コードが関係する読み込みファイルは、テキストコンテンツが記載されたtxtファイルや、データを記載したCSVファイルがあります。
Python3では、文字コードに関しPython側で処理してくれることが多くなり、文字コードエラーが少なくなりました。
unicode decode errorを回避するために正しい記述を理解する
unicode decode errorは、読み込みたいファイルの文字コードと、プログラムファイルの文字コードが異なる場合などに発生します。
エラーの原因はプログラムファイルの文字コードのせいでエラーが出る場合、コンピュータのデフォルト文字コードのせいでエラーが出る場合、など原因は複数あるます。
すべての場合に適用できるような解決策はありませんが、主要な解決策について紹介します。
encodingを指定する
読み出したいファイルの文字コードが違う場合には、encodingを指定するのが良いです。
次のように、ファイルを読み込む際に、関数の引数にencodingを指定すると良いでしょう。
file_data = open(file, 'r', encoding="utf-8")
プログラムの文字コードを変える
Pythonのプログラムファイルの文字コードの設定を変える場合は、プログラムファイルの冒頭に次の記述を記載します。
# -*- coding: utf-8 -*-
実は私も!?独学で損する人の特徴
「スクールは高いから独学で成功する」という気持ちの方は多いと思います。
もちろんその方が金額は低く抑えられるでしょう。
ただ
独学には向き不向きがあり、実はスクールが向いている人も大勢います。
そんな方のために参考として、
テックアカデミー卒業生がスクールを選んだ理由
をご紹介します。
- ・困って挫折しそうなときに、質問や相談できる相手がいる環境で学んでいきたいなと思った
- ・わかった気になっているだけだったので、自分を追い込む環境に置いた方がいいと感じた
- ・スクールのカリキュラムで市場に求められるスキルを学ぶべきと思った

少しでも当てはまる部分があれば、
スクールが向いているかもしれません。
お試しのつもりで、まずは一度
無料相談
に参加してみませんか?
現役エンジニア・デザイナーに何でも気軽に相談できる30分
を
すべて無料で
できます。
無理な勧誘は一切ない
ので、お気軽にご参加ください。
まとめ
以上、この記事ではPythonにおけるUnicodeDecodeErrorについて解説しました。
UnicodeDecodeErrorは、読み込み元と、読み込むプログラムの文字コードの違いなどで発生しました。
UnicodeDecodeErrorを回避する方法として、encodingを指定する方法や、プログラムの文字コードを変える方法がありました。

内容が分かりやすくて良かったです!

ゆかりちゃんも分からないことがあったら質問してね!

分かりました。ありがとうございます!
Pythonを学習中の方へ
これで解説は終了です、お疲れさまでした。
- つまずかず「効率的に」学びたい
- 副業や転職後の「現場で使える」知識やスキルを身につけたい
プログラミングを学習していて、このように思ったことはありませんか?
テックアカデミーのPythonコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。
合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、人工知能(AI)や機械学習の基礎を学べます。
まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。
時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします!

プログラミングを独学していて、このように感じた経験はないでしょうか?
- ・調べてもほしい情報が見つからない
- ・独学のスキルが実際の業務で通用するのか不安
- ・目標への学習プランがわからず、迷子になりそう
テックアカデミーでは、このような
学習に不安を抱えている方へ、現役エンジニア講師とマンツーマンで相談できる機会を無料で提供
しています。
30分間、オンラインでどんなことでも質問し放題です。
「受けてよかった」と感じていただけるよう
厳しい試験を通過した講師
があなたの相談に真摯に向き合います。
「ただ気になることを相談したい」
「漠然としているがプロの話を聞いてみたい」
こんな気持ちでも大丈夫です。
無理な勧誘は一切ありません
ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。(1週間限定)