Pythonでファイルに書き込む方法【初心者向け】

初心者向けにPythonでファイルに書き込む方法について解説しています。最初にテキストファイルに書き込みを行う場合の手順と方法を覚え、次に実際の例で練習します。実行後のファイルも確認しながら操作を学習しましょう。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

Pythonでテキストファイルに書き込む方法について解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事をまずご覧ください。

 

なお本記事は、TechAcademyのPythonオンライン講座の内容をもとにしています。

 

田島悠介

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

大石ゆかり

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

田島悠介

テキストファイルに書き込みを行う方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

ファイルを開く方法

Pythonでテキストファイルに書き込みを行う場合、以下の操作を行います。

  1. ファイルを開く
  2. データを書き込む
  3. ファイルを閉じる

まずは、ファイルを開く/閉じる方法を確認しましょう。

ファイルオブジェクト = open(ファイル名, "モード", encoding = "文字コード")
ファイルオブジェクト.close()

ファイルを開いた結果を、ファイルオブジェクトとして変数に取得します。この変数を用いて、ファイルへの書き込みを行います。

モードは3種類あります。

  • “w”:新規作成(既に同名のファイルが存在すれば上書き)
  • “x”:新規作成(既に同名のファイルが存在すればエラー)
  • “a”:追記(既に同名のファイルが存在すれば末尾に追記)

encodingには文字コードを指定します。特別な理由が無ければ「utf_8」を指定しましょう。

 

ファイルに書き込む方法

次にファイルにデータを書き込む方法を確認しましょう。

ファイルオブジェクト.write(データ)

ファイルにデータを書き込む際には、ファイルを開いた時に取得した、ファイルオブジェクトを使います。

 

[PR] Pythonで挫折しない学習方法を動画で公開中

実際に書いてみよう

今回のサンプルプログラムでは、「hello.txt」というファイルに、あいさつを書き込んでいます。「\n」は「改行」を表します。Macの場合は、option+¥ で入力出来ます。

ソースコード

file = "hello.txt"
fileobj = open(file, "w", encoding = "utf_8")
fileobj.write("こんにちは\n")
fileobj.write("Hello\n")
fileobj.write("你好\n")
fileobj.close()

実行すると、サンプルプログラムと同じフォルダに「hello.txt」というファイルが作成されます。実行結果は以下のようになります。

こんにちは
Hello
你好

なお、ファイルを読み込む場合は以下のように記述します。ファイルを開く/閉じるは上記と同様です。readメソッドで読み込みを行います。読み込んだ結果は文字列としてdata変数に取得されます。

ソースコード

fileobj = open(file)
data = fileobj.read()
fileobj.close()
print(data)

実行結果は以下のようになります。

こんにちは
Hello
你好

 

この記事を監修してくれた方

太田和樹(おおたかずき)
ITベンチャー企業のPM兼エンジニア

普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。

開発実績:画像認識技術を活用した駐車場混雑状況把握(実証実験)、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント

地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。

 

大石ゆかり

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

田島悠介

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

大石ゆかり

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

オンラインのプログラミングスクールTechAcademyではPythonを使って機械学習の基礎を学ぶPythonオンライン講座を開催しています。

初心者向けの書籍を使って人工知能(AI)や機械学習について学ぶことができます。

現役エンジニアがパーソナルメンターとして受講生に1人ずつつき、マンツーマンのメンタリングで学習をサポートし、最短4週間で習得することが可能です。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。