「せっかくPythonでデータを取り出せたのに、黒い画面(ターミナル)に出た結果をマウスでなぞってコピーして、メモ帳に貼り付けるの…めんどくさいな…」
そんなふうに思ったことはありませんか?
処理回数が増えるほど大きな負担になりますよね。また、手作業による転記ミスが発生するリスクも避けられません。
Pythonのファイル書き込み機能を活用すれば、プログラムの処理結果を直接テキストファイルに出力し、作業の自動化を図ることが可能になります。今回は、実務で頻繁に利用されるファイルへの書き込み手順と、安全にファイルを扱うための基本構文について解説します。
ファイル操作の基本的な流れ
ファイルへのデータ出力は、日常の事務作業でノートにメモを記録する手順と同じです。
- ノートを開く(ファイルを開く)
- ペンで文字を書く(テキストデータを書き込む)
- ノートを閉じる(ファイルを閉じる)
1点だけ注意が必要なのが、最後の「ファイルを閉じる」処理です。ファイルを開いたままプログラムが終了したり異常停止したりすると、バッファ内のデータが正常に保存されなかったり、ファイルがロックされて他のアプリケーションからアクセスできなくなったりする原因になります。
Pythonでは、こうした問題を防止するためにwith文を用いた記述が推奨されています。withブロックを抜ける際に自動的にファイルを閉じる処理(close())が実行されるため、安全にファイルを扱うことができます。
新規ファイルへの書き込み手順
新しいファイルを作成してテキストを保存する基本的なコード例をご紹介します。
# 新規作成モード("w" = write)でファイルを開きます
# 文字化けを防止するため、encoding="utf-8" を指定
with open("result.txt", "w", encoding="utf-8") as f:
# write() メソッドで文字列をファイルに出力
# 改行を行う場合は行末に "\n" を付与
f.write("本日の売上集計:10,000円\n")
f.write("目標達成率:100%\n")
print("ファイルへの書き込みが完了しました")
このコードを実行すると、プログラムと同じ階層にresult.txtが生成され、指定した文字列が記録されます。書き込みモード(”w”)で既存のファイルを指定した場合、中身がすべて上書きされて内容が初期化されますので注意が必要になります。
既存ファイルへデータを追加する追記モード
毎日の実行ログや定期的な集計データなど、既存の内容を保持したまま末尾に新しいデータを足していきたい場合は、追記モード(”a” = append)を使用します。
# 追記モード("a" = append")でファイルを開きます
with open("result.txt", "a", encoding="utf-8") as f:
# 既存のテキストの末尾に新しい行が追加されます
f.write("追記メモ:翌営業日の処理スケジュールを確認済み\n")
print("データの追記が完了いたしました。")
追記モードを利用する際は、あわせて日時情報(datetimeモジュールなど)を記録しておくと、いつ実行されたログなのかを後から追跡できるようになり、実務での運用管理が格段に簡単になります!
実務におけるファイル書き込みの注意点
安全かつ安定してファイル書き込みを運用するために、以下の2点を意識することが大切になります。
- 文字コードの指定:Windows環境とMac/Linux環境でデフォルトの文字コードが異なる場合があるため、encoding=”utf-8″を明記して環境依存の文字化けを防ぎましょう。
- 数値の文字列変換:write()メソッドに渡せるのは文字列型(str)のみになります。数値データを書き込む場合は、f.write(str(total_price)) のように文字列への型変換を行うか、f文字列(f”{total_price}\n”)を活用して記述しましょう。
こうした基本ルールを押さえておくことで、スクレイピング結果の保存や日常のデータ集計ログの出力など、様々な自動化処理を安心して構築できるようになります。ぜひ取り入れてみてください!
Pythonの本は種類が多すぎて、業務効率化に使えるのか見分けるのが大変ですよね。実務自動化に5年以上携わってきた私が、「デスクワークの自動化に即戦力になった本」を厳選して紹介します。失敗しない1冊を見つけたい方は、ぜひ参考にしてみてください。

コメント