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

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

TechAcademyマガジンは受講者数No.1のオンラインプログラミングスクールTechAcademy [テックアカデミー]が運営。初心者向けに解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。

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("Hellon")
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を使った人工知能(AI)や機械学習の基礎を習得できるオンラインブートキャンプPython講座を開催しています。

挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。