PythonでCSVが読み込めない原因と解決法

この記事で分かること

  • PythonでCSVが読み込めないよくある原因
  • 仕事で実際に起きやすいエラーの対処法
  • ChatGPTを使って最短で解決する質問方法

「CSVが読み込めずに仕事が止まった…」
そんなときにすぐ解決できることを目的に書いています。


よくある症状(まずは確認)

PythonでCSVを扱うと、次のようなトラブルがよく起きます。

  • ファイルが見つからない
  • 文字化けする
  • エラーが出ないのにデータが空
  • Excelでは開けるのにPythonでは失敗する

仕事でPythonを使う場合、環境依存の問題が原因になることも多いです。


原因①:ファイルパスが間違っている(最頻出)

エラー例

FileNotFoundError: [Errno 2] No such file or directory

原因

  • CSVファイルの場所が違う
  • 相対パスと絶対パスを勘違いしている
  • 実行場所(カレントディレクトリ)が想定と違う

解決方法

まず 絶対パス を使って確認しましょう。

import pandas as pd

df = pd.read_csv(r"C:\data\sample.csv")
print(df.head())

※ Windowsでは r"パス" を使うと安全です。


原因②:文字コードが違う(日本語CSVで多発)

症状

  • 文字化けする
  • 以下のようなエラーが出る
UnicodeDecodeError: 'utf-8' codec can't decode byte

解決方法

日本の業務CSVは Shift-JIS のことが多いです。

df = pd.read_csv("sample.csv", encoding="shift_jis")

よく使う文字コード

  • utf-8
  • shift_jis
  • cp932(Windows Excel)

原因③:区切り文字がカンマではない

CSVといっても、実務では タブ区切りセミコロン区切り があります。

解決方法

df = pd.read_csv("sample.csv", sep="\t")

区切り文字が分からない場合は、
メモ帳でCSVを開いて確認するのが確実です。


原因④:Excelで開きっぱなし(意外と多い)

症状

  • PermissionError が出る
  • 読み込みに失敗する

解決方法

  • Excelを完全に閉じる
  • OneDrive同期中でないか確認
PermissionError: [Errno 13] Permission denied

原因⑤:空行・余計な列がある

業務CSVは 人の手が入っている ことが多く、
空行や不要な列が原因で失敗することがあります。

解決方法

df = pd.read_csv("sample.csv", skip_blank_lines=True)

【実務で使える】ChatGPTで最短解決する方法

エラーに時間をかけたくない場合、
ChatGPTを正しく使うと解決速度が段違いです。

おすすめ質問テンプレ

PythonでCSVを読み込もうとすると
以下のエラーが出ます。

エラー内容:
UnicodeDecodeError: 'utf-8' codec can't decode byte

原因と初心者向けの解決方法を教えてください。

ポイント

  • エラー全文をそのまま貼る
  • 「初心者向け」と明記する
  • CSVの作成元(Excelなど)を書くと精度UP

仕事でCSVを扱うときの注意点まとめ

  • パスはまず絶対パスで確認
  • 文字コードは最初に疑う
  • Excelを閉じてから実行
  • CSVは「人の手」が入っている前提で考える

まとめ

PythonでCSVが読み込めない原因は、
ほとんどが環境・文字コード・パスです。

1つずつ確認すれば、必ず解決できます。


次回の記事では
👉 「ModuleNotFoundErrorの原因と正しい直し方」
を、仕事でよくあるケース中心に解説します。

コメント

仕事で使えるPython×ChatGPT入門をもっと見る

今すぐ購読し、続きを読んで、すべてのアーカイブにアクセスしましょう。

続きを読む

タイトルとURLをコピーしました