icon
icon

Pythonにおけるunicode decode errorに関する回避方法を現役エンジニアが解説【初心者向け】

初心者向けにPythonにおけるunicode decode errorに関する回避方法について現役エンジニアが解説しています。ファイルの文字コードと、読み込みの際に指定している文字コードの種類が違うために、文字列に変換することが出来ない場合に生じるエラーです。エラーが出ないようにする方法を解説します。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

監修してくれたメンター

nakamoto

アジマッチ有限会社代表取締役社長。書籍化歓迎。対応業務:PHP(Laravel)、機械学習、Vue.js、LAMP・AWS、越境EC、CTO、エンジニア採用、CTO、経営者の不安解決コンサルティング。

Pythonにおけるunicode decode errorに関する回避方法について、テックアカデミーのメンター(現役エンジニア)が実際のコードを使用して初心者向けに解説します。

Pythonにおけるunicode decode errorを知っておくことで、実務でエラーが発生したときに対応できるようになります。

目次

そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

 

田島悠介

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

大石ゆかり

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

田島悠介

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

大石ゆかり

お願いします!

 

この記事では、Pythonでファイルを読み込もうとしたときに表示されることのある、UnicodeDecodeErrorに対する対処方法について説明します。

 

文字コードとは?

ファイル読み込み時のUnicodeDecodeErrorを回避するために、文字コードの解説をします。

文字コードというのは、それぞれの文字に割り振られた識別用のコードのことで、コンピュータで文字を表現するときに必要になってきます。

コンピュータやファイルの種類によって文字コードは変わってくるので、ファイルの読み込みや、ファイルの保存の際に意識しておく必要があります。

文字コードの種類には、UnicodeやUTF-8、ASCIIやシフトJISなどがあります。

次の文字コード表はWikipediaに有る資料の例です。

Pythonで使われている文字コードについて

 

decode errorとは?

decode errorというのは、文字コードを文字列に変換することができないことで生じるエラーです。

例えば次のような、指定文字コードと読み込み文字コードが異なる場合に発生します。

  1. データをPythonのstr型の文字列として読み込みたい場合に、指定文字コードと読み込み文字コードの種類が違う
  2. 文字列の結合などのデータ加工がしたい場合などに、指定文字コードと読み込み文字コードの種類が違う

Pythonで文字コードが関係する読み込みファイルは、テキストコンテンツが記載されたtxtファイルや、データを記載したCSVファイルがあります。

Python3では、文字コードに関しPython側で処理してくれることが多くなり、文字コードエラーが少なくなりました。

 

[PR] 未経験からWebエンジニアを目指す方法とは

unicode decode errorを回避するために正しい記述を理解する

unicode decode errorは、読み込みたいファイルの文字コードと、プログラムファイルの文字コードが異なる場合などに発生します。

エラーの原因はプログラムファイルの文字コードのせいでエラーが出る場合、コンピュータのデフォルト文字コードのせいでエラーが出る場合、など原因は複数あるます。

すべての場合に適用できるような解決策はありませんが、主要な解決策について紹介します。

encodingを指定する

読み出したいファイルの文字コードが違う場合には、encodingを指定するのが良いです。

次のように、ファイルを読み込む際に、関数の引数にencodingを指定すると良いでしょう。

file_data = open(file, 'r', encoding="utf-8")

 

プログラムの文字コードを変える

Pythonのプログラムファイルの文字コードの設定を変える場合は、プログラムファイルの冒頭に次の記述を記載します。

# -*- coding: utf-8 -*-

 

まとめ

以上、この記事ではPythonにおけるUnicodeDecodeErrorについて解説しました。

UnicodeDecodeErrorは、読み込み元と、読み込むプログラムの文字コードの違いなどで発生しました。

UnicodeDecodeErrorを回避する方法として、encodingを指定する方法や、プログラムの文字コードを変える方法がありました。

大石ゆかり

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

田島悠介

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

大石ゆかり

分かりました。ありがとうございます!

 

Pythonを学習中の方へ

これで解説は終了です、お疲れさまでした。

  • つまずかず「効率的に」学びたい
  • 副業や転職後の「現場で使える」知識やスキルを身につけたい

プログラミングを学習していて、このように思ったことはありませんか?

テックアカデミーのPythonコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。

合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、人工知能(AI)や機械学習の基礎を学べます。

まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。

時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします!