【Python】ValueError: Cannot convert (‘木’,) to Excel が発生した原因と対処法｜openpyxlエラー完全解説

2022年6月22日2025年12月21日

使用環境

OS：Windows 10 Pro（バージョン：20H2）
言語：Python（pandas、openpyxl使用）

経緯

Pythonを使い、pandasで抽出したデータをopenpyxl経由でExcelに貼り付けようとしたところ、
次のエラーが発生しました。

ValueError: Cannot convert ('木',) to Excel

データを確認すると、
**「木」「林」「森」「4」「8」「12」**と並ぶ表があり、
1行目にカラム、2行目にデータが存在している構成でした。

このエラーへの対処と、より良いやり方を整理しました。

エラー原因

今回のエラーは、
セルに渡そうとした値が文字列ではなく、タプル型（tuple）になっていたために発生しています。

openpyxlでは、
文字列型（str）、数値型（int、float）、日付型（datetime）などのシンプルな型しか、セルに書き込むことができません。
タプルやリストなどの複合型をそのまま渡すとエラーになります。

あなたが採った応急処置方法（正しいアプローチ）

一旦データをすべて数値に変換してから貼り付ける
その後、カラム名（木・林・森）を個別に手動で設定する

これは確かに実用的で正しいやり方です。
しかし、もっとスマートにエラーを防ぎながらデータを貼り付ける方法も存在します。

根本的な対処法：タプルを文字列に変換してから貼り付ける

タプルをセルに渡す直前で文字列に変換してしまえば、
エラーなく処理できます。

改善版コード

import openpyxl
from openpyxl.utils.dataframe import dataframe_to_rows

# ワークブックとシート作成
wb = openpyxl.Workbook()
ws = wb.active
ws.title = "sheet1"

# データフレームを行ごとに取得
rows = dataframe_to_rows(data, index=False, header=True)

row_start = 1
col_start = 1

for row_no, row in enumerate(rows, row_start):
    for col_no, value in enumerate(row, col_start):
        # タプル型なら文字列に変換
        if isinstance(value, tuple):
            value = "".join(map(str, value))
        ws.cell(row=row_no, column=col_no).value = value