<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>ファイル操作 &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/tag/file-operations/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Thu, 19 Nov 2026 21:55:16 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://cfxlog.com/wp-content/uploads/2026/07/cfxlog-favicon-150x150.png</url>
	<title>ファイル操作 &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>openpyxlの使い方｜PythonでExcelを読み込み・書き込みする基本</title>
		<link>https://cfxlog.com/python-openpyxl-excel/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 06 Nov 2026 01:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[Excel自動化]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/python-openpyxl-excel/</guid>

					<description><![CDATA[僕は、Excel のデータを読み書きするとき、書式（装飾）が崩れてもかまわない場面では openpyxl を使っています。体感で速いですし、OS に関係なく、Excel がインストールされていない Mac や Linux [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Python で Excel ファイルを読み込んだり、書き込んだりしたい</li>

<li>openpyxl と win32com のどちらを使えばいいか迷っている</li>

<li>数式の値が None になる、大きなファイルでメモリが足りない、といった問題で困っている</li>
</ul>
</div></div>



<p class="wp-block-paragraph">僕は、Excel のデータを読み書きするとき、<strong>書式（装飾）が崩れてもかまわない場面では openpyxl</strong> を使っています。体感で速いですし、OS に関係なく、Excel がインストールされていない Mac や Linux でも同じコードで動くからです。</p>



<p class="wp-block-paragraph">この記事では、openpyxl でブックを作る・読む・書き換える・複数シートを扱う・数式を扱う・大きなファイルを扱う、という基本を、<strong>実際に動かしたコードと出力つき</strong>でまとめます。あわせて、win32com との使い分けと、openpyxl で保存し直したときに何が残り何が消えるかを、確かめた範囲で書きます。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>この記事で動かした環境（2026年11月18日）</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li>macOS 27.2（Apple シリコン）</li>

<li>Python 3.12.16</li>

<li>openpyxl 3.1.5（uv で追加）</li>

<li>Excel 本体は使っていません。保存したファイルは openpyxl で読み直して確かめています</li>
</ul>
</div></div>



<h2 class="wp-block-heading">openpyxl と win32com の使い分け</h2>



<p class="wp-block-paragraph">Python から Excel を扱う方法として、openpyxl のほかに win32com（pywin32）があります。win32com は Excel 本体を Python から操作する方法で、<a href="https://cfxlog.com/python-win32com-excel/">こちらの記事</a>で詳しく紹介しています。</p>



<h3 class="wp-block-heading">僕の使い分け</h3>



<figure class="wp-block-table"><table><thead><tr><th></th><th>openpyxl</th><th>win32com</th></tr></thead><tbody><tr><td>必要なもの</td><td>Python と openpyxl だけ</td><td>Windows と Excel 本体</td></tr><tr><td>動く OS</td><td>Windows・Mac・Linux</td><td>Windows のみ</td></tr><tr><td>しくみ</td><td>xlsx ファイルを直接読み書きする</td><td>Excel を起動して操作する</td></tr><tr><td>向いている作業</td><td>データの読み書き、集計結果の書き出し</td><td>書式やマクロを保ったまま編集したいとき</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">僕は、装飾が壊れてもいいときは openpyxl を使います。「中身のデータだけ取り出したい」「集計結果を新しいファイルに書き出したい」なら openpyxl、「会社で使っている書式付きのテンプレートやマクロを崩さずに書き込みたい」なら、Windows と Excel 本体が要りますが win32com、という使い分けです。</p>



<h3 class="wp-block-heading">openpyxl で開いて保存し直したときに残ったもの・消えたもの</h3>



<p class="wp-block-paragraph">openpyxl はファイルを読み込んで自分の形に置き換え、保存するときに書き直します。そのため、openpyxl が扱えないものは保存し直すと消えることがあります。今回は次の2つを確かめました。</p>



<ul class="wp-block-list">
<li>openpyxl で装飾・グラフ付きのブックを作り、それを開いて保存し直す</li>

<li>マクロの部品（<code>xl/vbaProject.bin</code>）を入れたテスト用の .xlsm を、開いて保存し直す</li>
</ul>



<figure class="wp-block-table"><table><thead><tr><th>確かめたもの</th><th>結果</th></tr></thead><tbody><tr><td>文字の太字・塗りつぶし・列幅</td><td>残った</td></tr><tr><td>セルの結合・コメント・ウィンドウ枠の固定</td><td>残った</td></tr><tr><td>入力規則・条件付き書式</td><td>残った</td></tr><tr><td>openpyxl で作った棒グラフ</td><td>残った</td></tr><tr><td>マクロの部品（そのまま開いて保存）</td><td><strong>消えた</strong></td></tr><tr><td>マクロの部品（<code>keep_vba=True</code> で開いて .xlsm で保存）</td><td>残った</td></tr><tr><td>マクロの部品（<code>keep_vba=True</code> なしで開いて .xlsx で保存）</td><td><strong>消えた</strong></td></tr></tbody></table><figcaption class="wp-element-caption">openpyxl 3.1.5 で確認（2026年11月18日）</figcaption></figure>



<p class="wp-block-paragraph">マクロの確認に使ったのは、Excel で作ったマクロではなく、中身がダミーの部品を入れたテスト用ファイルです。そのため「マクロが Excel で動くか」までは確かめていません。マクロ付きのファイルを openpyxl で扱うときは、少なくとも <code>load_workbook("ファイル.xlsm", keep_vba=True)</code> で開き、.xlsm で保存してください。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>注意：Excel で作った画像・グラフ・図形は今回確かめていない</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">今回の環境には Excel がないため、Excel で作った画像・グラフ・図形が openpyxl で保存し直したあとにどうなるかは確かめていません。上の表で残ったのは openpyxl 自身が作ったグラフです。<a href="https://cfxlog.com/python-win32com-excel/">win32com の記事</a>で書いた「openpyxl で保存したらグラフが消えた」は Excel で作ったグラフの話で、その対処も win32com の記事で扱っています。大事なファイルは、上書きせず別名で保存して中身を確かめるのがおすすめです。</p>
</div></div>



<h2 class="wp-block-heading">openpyxl をインストールする</h2>



<h3 class="wp-block-heading">uv で追加する</h3>



<p class="wp-block-paragraph">僕は uv でプロジェクトを管理しているので、<code>uv add</code> で追加しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add openpyxl</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">openpyxl</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 3 packages in 2ms
Installed 2 packages in 4ms
 + et-xmlfile==2.0.0
 + openpyxl==3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 3 packages in 2ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 2 packages in 4ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4"> + openpyxl==3.1.5</span></span></code></pre></div>



<p class="wp-block-paragraph">pip を使っている場合は <code>pip install openpyxl</code> で入ります。この記事のスクリプトは、どれも <code>uv run python ファイル名.py</code> で実行しています。</p>



<h3 class="wp-block-heading">バージョンを確認する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run python -c "import sys, openpyxl; print(sys.version.split()[0], openpyxl.__version__)"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;import sys, openpyxl; print(sys.version.split()[0], openpyxl.__version__)&quot;</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>3.12.16 3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">3.12.16 3.1.5</span></span></code></pre></div>



<h2 class="wp-block-heading">Excel ファイルを新しく作る</h2>



<h3 class="wp-block-heading">Workbook でブックを作ってセルに書く</h3>



<p class="wp-block-paragraph">新しいブックは <code>Workbook()</code> で作ります。最初から1枚のシートがあり、<code>wb.active</code> で取り出せます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from datetime import date

from openpyxl import Workbook

wb = Workbook()
ws = wb.active
ws.title = "売上"

# 1行目に見出しを書く
ws["A1"] = "日付"
ws["B1"] = "商品"
ws["C1"] = "数量"
ws["D1"] = "単価"

# 行をまとめて追加する
ws.append([date(2026, 11, 1), "りんご", 3, 120])
ws.append([date(2026, 11, 2), "みかん", 5, 80])
ws.append([date(2026, 11, 3), "ぶどう", 1, 450])

# 行・列の番号で書く（1始まり）
ws.cell(row=5, column=2, value="合計")

wb.save("sales.xlsx")
print("保存しました:", ws.max_row, "行", ws.max_column, "列")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> datetime </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> date</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb = Workbook()</span></span>
<span class="line"><span style="color: #D4D4D4">ws = wb.active</span></span>
<span class="line"><span style="color: #D4D4D4">ws.title = </span><span style="color: #CE9178">&quot;売上&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 1行目に見出しを書く</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;A1&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #CE9178">&quot;日付&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;B1&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #CE9178">&quot;商品&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;C1&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #CE9178">&quot;数量&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;D1&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #CE9178">&quot;単価&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 行をまとめて追加する</span></span>
<span class="line"><span style="color: #D4D4D4">ws.append([date(</span><span style="color: #B5CEA8">2026</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">11</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">), </span><span style="color: #CE9178">&quot;りんご&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">120</span><span style="color: #D4D4D4">])</span></span>
<span class="line"><span style="color: #D4D4D4">ws.append([date(</span><span style="color: #B5CEA8">2026</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">11</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">), </span><span style="color: #CE9178">&quot;みかん&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">5</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">80</span><span style="color: #D4D4D4">])</span></span>
<span class="line"><span style="color: #D4D4D4">ws.append([date(</span><span style="color: #B5CEA8">2026</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">11</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">), </span><span style="color: #CE9178">&quot;ぶどう&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">450</span><span style="color: #D4D4D4">])</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 行・列の番号で書く（1始まり）</span></span>
<span class="line"><span style="color: #D4D4D4">ws.cell(</span><span style="color: #9CDCFE">row</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">5</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">column</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">value</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;合計&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb.save(</span><span style="color: #CE9178">&quot;sales.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;保存しました:&quot;</span><span style="color: #D4D4D4">, ws.max_row, </span><span style="color: #CE9178">&quot;行&quot;</span><span style="color: #D4D4D4">, ws.max_column, </span><span style="color: #CE9178">&quot;列&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>保存しました: 5 行 4 列</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">保存しました: 5 行 4 列</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>sales.xlsx</code> ができました。ポイントは次の3つです。</p>



<figure class="wp-block-table"><table><thead><tr><th>書き方</th><th>意味</th></tr></thead><tbody><tr><td><code>ws["A1"] = "日付"</code></td><td>セル番地を指定して書く</td></tr><tr><td><code>ws.append([...])</code></td><td>いちばん下の行の次に、1行まとめて追加する</td></tr><tr><td><code>ws.cell(row=5, column=2, value=...)</code></td><td>行と列の番号で書く（どちらも1始まり）</td></tr></tbody></table></figure>



<h3 class="wp-block-heading">日付はそのまま渡す</h3>



<p class="wp-block-paragraph"><code>datetime.date</code> の値はそのまま書き込めます。あとで読み込むと <code>datetime.datetime</code> として返ってきました（次の章の出力を見てください）。</p>



<h2 class="wp-block-heading">Excel ファイルを読み込む</h2>



<h3 class="wp-block-heading">load_workbook でシートとセルを読む</h3>



<p class="wp-block-paragraph">既存のファイルは <code>load_workbook()</code> で開きます。先ほどの <code>sales.xlsx</code> を読みます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from openpyxl import load_workbook

wb = load_workbook("sales.xlsx")
print(wb.sheetnames)

ws = wb["売上"]
print(ws["B2"].value)
print(ws.cell(row=2, column=3).value)
print(repr(ws["A2"].value))
print(ws.max_row, ws.max_column, ws.dimensions)

# 2行目から最終行まで、値だけを取り出す
for row in ws.iter_rows(min_row=2, values_only=True):
    print(row)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> load_workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb = load_workbook(</span><span style="color: #CE9178">&quot;sales.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(wb.sheetnames)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">ws = wb[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(ws[</span><span style="color: #CE9178">&quot;B2&quot;</span><span style="color: #D4D4D4">].value)</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(ws.cell(</span><span style="color: #9CDCFE">row</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">column</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">).value)</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">repr</span><span style="color: #D4D4D4">(ws[</span><span style="color: #CE9178">&quot;A2&quot;</span><span style="color: #D4D4D4">].value))</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(ws.max_row, ws.max_column, ws.dimensions)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 2行目から最終行まで、値だけを取り出す</span></span>
<span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> row </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> ws.iter_rows(</span><span style="color: #9CDCFE">min_row</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">values_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(row)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>['売上']
りんご
3
datetime.datetime(2026, 11, 1, 0, 0)
5 4 A1:D5
(datetime.datetime(2026, 11, 1, 0, 0), 'りんご', 3, 120)
(datetime.datetime(2026, 11, 2, 0, 0), 'みかん', 5, 80)
(datetime.datetime(2026, 11, 3, 0, 0), 'ぶどう', 1, 450)
(None, '合計', None, None)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">[&apos;売上&apos;]</span></span>
<span class="line"><span style="color: #D4D4D4">りんご</span></span>
<span class="line"><span style="color: #D4D4D4">3</span></span>
<span class="line"><span style="color: #D4D4D4">datetime.datetime(2026, 11, 1, 0, 0)</span></span>
<span class="line"><span style="color: #D4D4D4">5 4 A1:D5</span></span>
<span class="line"><span style="color: #D4D4D4">(datetime.datetime(2026, 11, 1, 0, 0), &apos;りんご&apos;, 3, 120)</span></span>
<span class="line"><span style="color: #D4D4D4">(datetime.datetime(2026, 11, 2, 0, 0), &apos;みかん&apos;, 5, 80)</span></span>
<span class="line"><span style="color: #D4D4D4">(datetime.datetime(2026, 11, 3, 0, 0), &apos;ぶどう&apos;, 1, 450)</span></span>
<span class="line"><span style="color: #D4D4D4">(None, &apos;合計&apos;, None, None)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>wb.sheetnames</code> でシート名の一覧、<code>wb["売上"]</code> でシートを取り出します。セルの値は <code>.value</code> で読みます。</p>



<h3 class="wp-block-heading">iter_rows で表を1行ずつ読む</h3>



<p class="wp-block-paragraph"><code>iter_rows(values_only=True)</code> を使うと、1行ずつ値のタプルで受け取れます。<code>min_row=2</code> で見出しの行を飛ばしています。空のセルは <code>None</code> になります。</p>



<p class="wp-block-paragraph">表のデータを集計したり並べ替えたりしたいなら、pandas で読み込むほうが楽なこともあります。pandas の基本は<a href="https://cfxlog.com/python-pandas-basics/">こちらの記事</a>にまとめています。</p>



<h3 class="wp-block-heading">max_row は「セルが作られた最後の行」</h3>



<p class="wp-block-paragraph"><code>ws.max_row</code> と <code>ws.max_column</code> は、値や書式が入った（作られた）セルの最後の行・列です。今回は5行目に「合計」とだけ書いたので、<code>max_row</code> は 5、<code>ws.dimensions</code> は <code>A1:D5</code> になりました。</p>



<p class="wp-block-paragraph">値が入っていなくても伸びることがあります。2行だけ書いたシートで試しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from openpyxl import Workbook
from openpyxl.styles import Font

wb = Workbook()
ws = wb.active
ws.append(["日付", "商品"])
ws.append(["2026-11-01", "りんご"])
print("書いた直後:", ws.max_row, ws.dimensions)

ws["A10"].font = Font(bold=True)  # 値は入れず書式だけ
print("A10 に書式だけ:", ws.max_row, ws.dimensions)

print(ws["B20"].value)  # 読むために参照しただけ
print("B20 を参照しただけ:", ws.max_row, ws.dimensions)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Workbook</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl.styles </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Font</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb = Workbook()</span></span>
<span class="line"><span style="color: #D4D4D4">ws = wb.active</span></span>
<span class="line"><span style="color: #D4D4D4">ws.append([</span><span style="color: #CE9178">&quot;日付&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;商品&quot;</span><span style="color: #D4D4D4">])</span></span>
<span class="line"><span style="color: #D4D4D4">ws.append([</span><span style="color: #CE9178">&quot;2026-11-01&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;りんご&quot;</span><span style="color: #D4D4D4">])</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;書いた直後:&quot;</span><span style="color: #D4D4D4">, ws.max_row, ws.dimensions)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;A10&quot;</span><span style="color: #D4D4D4">].font = Font(</span><span style="color: #9CDCFE">bold</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 値は入れず書式だけ</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;A10 に書式だけ:&quot;</span><span style="color: #D4D4D4">, ws.max_row, ws.dimensions)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(ws[</span><span style="color: #CE9178">&quot;B20&quot;</span><span style="color: #D4D4D4">].value)  </span><span style="color: #6A9955"># 読むために参照しただけ</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;B20 を参照しただけ:&quot;</span><span style="color: #D4D4D4">, ws.max_row, ws.dimensions)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>書いた直後: 2 A1:B2
A10 に書式だけ: 10 A1:B10
None
B20 を参照しただけ: 20 A1:B20</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">書いた直後: 2 A1:B2</span></span>
<span class="line"><span style="color: #D4D4D4">A10 に書式だけ: 10 A1:B10</span></span>
<span class="line"><span style="color: #D4D4D4">None</span></span>
<span class="line"><span style="color: #D4D4D4">B20 を参照しただけ: 20 A1:B20</span></span></code></pre></div>



<p class="wp-block-paragraph">書式だけを付けたセルや、値を読むために <code>ws["B20"]</code> と参照しただけの空のセルも、その時点で作られて <code>max_row</code> が伸びました。表の下にメモがある場合も含まれるので、データの最後の行を知りたいときは、値が入っているかを自分で確かめるほうが確実です。</p>



<h2 class="wp-block-heading">既存のファイルを書き換えて保存する</h2>



<h3 class="wp-block-heading">セルを書き換えて行を挿入する</h3>



<p class="wp-block-paragraph">読み込んだブックのセルに値を入れ、<code>save()</code> すれば書き換えられます。<code>insert_rows(5)</code> は、5行目の位置に空の行を1行入れます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from datetime import date

from openpyxl import load_workbook

wb = load_workbook("sales.xlsx")
ws = wb["売上"]

ws["C3"] = 6  # みかんの数量を直す
ws.insert_rows(5)  # 「合計」の行の上に1行空ける
ws["A5"] = date(2026, 11, 4)
ws["B5"] = "もも"
ws["C5"] = 2
ws["D5"] = 300

wb.save("sales_updated.xlsx")

for row in load_workbook("sales_updated.xlsx")["売上"].iter_rows(values_only=True):
    print(row)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> datetime </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> date</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> load_workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb = load_workbook(</span><span style="color: #CE9178">&quot;sales.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">ws = wb[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;C3&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #B5CEA8">6</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># みかんの数量を直す</span></span>
<span class="line"><span style="color: #D4D4D4">ws.insert_rows(</span><span style="color: #B5CEA8">5</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 「合計」の行の上に1行空ける</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;A5&quot;</span><span style="color: #D4D4D4">] = date(</span><span style="color: #B5CEA8">2026</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">11</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">4</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;B5&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #CE9178">&quot;もも&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;C5&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #B5CEA8">2</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;D5&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #B5CEA8">300</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb.save(</span><span style="color: #CE9178">&quot;sales_updated.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> row </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> load_workbook(</span><span style="color: #CE9178">&quot;sales_updated.xlsx&quot;</span><span style="color: #D4D4D4">)[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">].iter_rows(</span><span style="color: #9CDCFE">values_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(row)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>('日付', '商品', '数量', '単価')
(datetime.datetime(2026, 11, 1, 0, 0), 'りんご', 3, 120)
(datetime.datetime(2026, 11, 2, 0, 0), 'みかん', 6, 80)
(datetime.datetime(2026, 11, 3, 0, 0), 'ぶどう', 1, 450)
(datetime.datetime(2026, 11, 4, 0, 0), 'もも', 2, 300)
(None, '合計', None, None)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">(&apos;日付&apos;, &apos;商品&apos;, &apos;数量&apos;, &apos;単価&apos;)</span></span>
<span class="line"><span style="color: #D4D4D4">(datetime.datetime(2026, 11, 1, 0, 0), &apos;りんご&apos;, 3, 120)</span></span>
<span class="line"><span style="color: #D4D4D4">(datetime.datetime(2026, 11, 2, 0, 0), &apos;みかん&apos;, 6, 80)</span></span>
<span class="line"><span style="color: #D4D4D4">(datetime.datetime(2026, 11, 3, 0, 0), &apos;ぶどう&apos;, 1, 450)</span></span>
<span class="line"><span style="color: #D4D4D4">(datetime.datetime(2026, 11, 4, 0, 0), &apos;もも&apos;, 2, 300)</span></span>
<span class="line"><span style="color: #D4D4D4">(None, &apos;合計&apos;, None, None)</span></span></code></pre></div>



<p class="wp-block-paragraph">みかんの数量が 6 になり、「合計」の行が6行目に下がって、空いた5行目に「もも」が入りました。</p>



<h3 class="wp-block-heading">保存先は元のファイルと別名にしておく</h3>



<p class="wp-block-paragraph"><code>save()</code> に元と同じファイル名を渡すと、確認なしで上書きされます。前の章のとおり、openpyxl で保存し直すと消えるものもあるので、慣れるまでは別名で保存して中身を確かめてから差し替えると安心です。</p>



<h2 class="wp-block-heading">複数のシートを扱う</h2>



<h3 class="wp-block-heading">シートの追加・コピー・削除</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from openpyxl import load_workbook

wb = load_workbook("sales.xlsx")

summary = wb.create_sheet("集計")  # 末尾に追加
memo = wb.create_sheet("メモ", 0)  # 先頭に追加
print(wb.sheetnames)

copied = wb.copy_worksheet(wb["売上"])  # 同じブックの中でコピー
copied.title = "売上_控え"
print(wb.sheetnames)

wb.remove(wb["メモ"])
print(wb.sheetnames)

# すべてのシートを順に見る
for ws in wb.worksheets:
    print(ws.title, ws.max_row)

wb.active = wb.sheetnames.index("集計")  # 開いたときに表示するシート
wb.save("sales_sheets.xlsx")
print("active:", load_workbook("sales_sheets.xlsx").active.title)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> load_workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb = load_workbook(</span><span style="color: #CE9178">&quot;sales.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">summary = wb.create_sheet(</span><span style="color: #CE9178">&quot;集計&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 末尾に追加</span></span>
<span class="line"><span style="color: #D4D4D4">memo = wb.create_sheet(</span><span style="color: #CE9178">&quot;メモ&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 先頭に追加</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(wb.sheetnames)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">copied = wb.copy_worksheet(wb[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">])  </span><span style="color: #6A9955"># 同じブックの中でコピー</span></span>
<span class="line"><span style="color: #D4D4D4">copied.title = </span><span style="color: #CE9178">&quot;売上_控え&quot;</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(wb.sheetnames)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb.remove(wb[</span><span style="color: #CE9178">&quot;メモ&quot;</span><span style="color: #D4D4D4">])</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(wb.sheetnames)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># すべてのシートを順に見る</span></span>
<span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> ws </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> wb.worksheets:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(ws.title, ws.max_row)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb.active = wb.sheetnames.index(</span><span style="color: #CE9178">&quot;集計&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 開いたときに表示するシート</span></span>
<span class="line"><span style="color: #D4D4D4">wb.save(</span><span style="color: #CE9178">&quot;sales_sheets.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;active:&quot;</span><span style="color: #D4D4D4">, load_workbook(</span><span style="color: #CE9178">&quot;sales_sheets.xlsx&quot;</span><span style="color: #D4D4D4">).active.title)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>['メモ', '売上', '集計']
['メモ', '売上', '集計', '売上_控え']
['売上', '集計', '売上_控え']
売上 5
集計 1
売上_控え 5
active: 集計</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">[&apos;メモ&apos;, &apos;売上&apos;, &apos;集計&apos;]</span></span>
<span class="line"><span style="color: #D4D4D4">[&apos;メモ&apos;, &apos;売上&apos;, &apos;集計&apos;, &apos;売上_控え&apos;]</span></span>
<span class="line"><span style="color: #D4D4D4">[&apos;売上&apos;, &apos;集計&apos;, &apos;売上_控え&apos;]</span></span>
<span class="line"><span style="color: #D4D4D4">売上 5</span></span>
<span class="line"><span style="color: #D4D4D4">集計 1</span></span>
<span class="line"><span style="color: #D4D4D4">売上_控え 5</span></span>
<span class="line"><span style="color: #D4D4D4">active: 集計</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>書き方</th><th>やること</th></tr></thead><tbody><tr><td><code>wb.create_sheet("集計")</code></td><td>末尾にシートを追加する</td></tr><tr><td><code>wb.create_sheet("メモ", 0)</code></td><td>指定した位置（0 は先頭）に追加する</td></tr><tr><td><code>wb.copy_worksheet(ws)</code></td><td>同じブックの中でシートをコピーする</td></tr><tr><td><code>wb.remove(ws)</code></td><td>シートを削除する</td></tr><tr><td><code>wb.worksheets</code></td><td>すべてのシートを順に取り出す</td></tr></tbody></table></figure>



<h3 class="wp-block-heading">開いたときに表示するシートを決める</h3>



<p class="wp-block-paragraph"><code>wb.active</code> にシートの番号を入れると、Excel で開いたときに最初に表示されるシートを決められます。保存して読み直すと、<code>active</code> が「集計」になっていました。新しいシートは中身が空なので、<code>max_row</code> は 1 です。</p>



<h2 class="wp-block-heading">数式の扱い（data_only）</h2>



<h3 class="wp-block-heading">数式は文字列として書き込む</h3>



<p class="wp-block-paragraph">セルに <code>=</code> から始まる文字列を入れると、数式として保存されます。読み込むときの <code>data_only</code> の違いも一緒に確かめました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from openpyxl import load_workbook

wb = load_workbook("sales.xlsx")
ws = wb["売上"]
for r in range(2, 5):
    ws[f"E{r}"] = f"=C{r}*D{r}"  # 金額 = 数量 × 単価
ws["E1"] = "金額"
ws["E5"] = "=SUM(E2:E4)"
wb.save("sales_formula.xlsx")

# そのまま読むと、数式の文字列が返る
ws = load_workbook("sales_formula.xlsx")["売上"]
print("通常:", ws["E2"].value, ws["E5"].value)

# data_only=True は「最後に計算された値」を読む
ws = load_workbook("sales_formula.xlsx", data_only=True)["売上"]
print("data_only:", ws["E2"].value, ws["E5"].value)

# data_only=True で開いたまま保存すると、数式はどうなるか
load_workbook("sales_formula.xlsx", data_only=True).save("sales_formula_dataonly.xlsx")
ws = load_workbook("sales_formula_dataonly.xlsx")["売上"]
print("data_only で保存後:", ws["E2"].value, ws["E5"].value)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> load_workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">wb = load_workbook(</span><span style="color: #CE9178">&quot;sales.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">ws = wb[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> r </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">range</span><span style="color: #D4D4D4">(</span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">5</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    ws[</span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;E</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">r</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;=C</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">r</span><span style="color: #569CD6">}</span><span style="color: #CE9178">*D</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">r</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 金額 = 数量 × 単価</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;E1&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #CE9178">&quot;金額&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">ws[</span><span style="color: #CE9178">&quot;E5&quot;</span><span style="color: #D4D4D4">] = </span><span style="color: #CE9178">&quot;=SUM(E2:E4)&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">wb.save(</span><span style="color: #CE9178">&quot;sales_formula.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># そのまま読むと、数式の文字列が返る</span></span>
<span class="line"><span style="color: #D4D4D4">ws = load_workbook(</span><span style="color: #CE9178">&quot;sales_formula.xlsx&quot;</span><span style="color: #D4D4D4">)[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;通常:&quot;</span><span style="color: #D4D4D4">, ws[</span><span style="color: #CE9178">&quot;E2&quot;</span><span style="color: #D4D4D4">].value, ws[</span><span style="color: #CE9178">&quot;E5&quot;</span><span style="color: #D4D4D4">].value)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># data_only=True は「最後に計算された値」を読む</span></span>
<span class="line"><span style="color: #D4D4D4">ws = load_workbook(</span><span style="color: #CE9178">&quot;sales_formula.xlsx&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">data_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;data_only:&quot;</span><span style="color: #D4D4D4">, ws[</span><span style="color: #CE9178">&quot;E2&quot;</span><span style="color: #D4D4D4">].value, ws[</span><span style="color: #CE9178">&quot;E5&quot;</span><span style="color: #D4D4D4">].value)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># data_only=True で開いたまま保存すると、数式はどうなるか</span></span>
<span class="line"><span style="color: #D4D4D4">load_workbook(</span><span style="color: #CE9178">&quot;sales_formula.xlsx&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">data_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">).save(</span><span style="color: #CE9178">&quot;sales_formula_dataonly.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">ws = load_workbook(</span><span style="color: #CE9178">&quot;sales_formula_dataonly.xlsx&quot;</span><span style="color: #D4D4D4">)[</span><span style="color: #CE9178">&quot;売上&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;data_only で保存後:&quot;</span><span style="color: #D4D4D4">, ws[</span><span style="color: #CE9178">&quot;E2&quot;</span><span style="color: #D4D4D4">].value, ws[</span><span style="color: #CE9178">&quot;E5&quot;</span><span style="color: #D4D4D4">].value)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>通常: =C2*D2 =SUM(E2:E4)
data_only: None None
data_only で保存後: None None</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">通常: =C2*D2 =SUM(E2:E4)</span></span>
<span class="line"><span style="color: #D4D4D4">data_only: None None</span></span>
<span class="line"><span style="color: #D4D4D4">data_only で保存後: None None</span></span></code></pre></div>



<h3 class="wp-block-heading">data_only=True で None になる理由</h3>



<p class="wp-block-paragraph">ふつうに読み込むと、数式の文字列（<code>=C2*D2</code>）がそのまま返ります。<code>data_only=True</code> は数式ではなく「最後に計算された値」を読む指定ですが、今回は <code>None</code> になりました。</p>



<p class="wp-block-paragraph">openpyxl は数式を計算しません。計算結果はふつう Excel がファイルを保存するときに一緒に書き込むもので、openpyxl で書いただけのファイルにはまだ計算結果が入っていないためです。計算結果が必要なら、Python 側で計算して値として書き込むのが確実です。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>注意：data_only=True で開いて保存すると数式が消える</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">最後の行のとおり、<code>data_only=True</code> で開いたブックを保存すると、読み直しても数式は残っていませんでした（今回は計算結果もなかったので <code>None</code>）。値を読むためのブックと、書き換えて保存するためのブックは分けて開きましょう。</p>
</div></div>



<h2 class="wp-block-heading">大きなファイルは read_only / write_only で扱う</h2>



<h3 class="wp-block-heading">10万行で比べた結果</h3>



<p class="wp-block-paragraph">10万行×5列のデータで、ふつうのモードと <code>write_only</code>・<code>read_only</code> を比べました。時間は1回ずつ測り、メモリは Python の <code>tracemalloc</code> で測った最大値です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>"""通常モードと write_only / read_only の時間・メモリを比べる（10万行×5列）。"""
import time
import tracemalloc
from pathlib import Path

from openpyxl import Workbook, load_workbook

N = 100_000


def measure(label, func):
    # 時間は tracemalloc なしで測る（tracemalloc を付けると遅くなるため）
    t = time.perf_counter()
    result = func()
    sec = time.perf_counter() - t
    # メモリは別にもう一度動かして、Python が確保した量の最大値を見る
    tracemalloc.start()
    func()
    peak = tracemalloc.get_traced_memory()[1] / 1024 / 1024
    tracemalloc.stop()
    print(f"{label}: {sec:.2f} 秒 / 最大 {peak:.1f} MB / {result}")


def write_normal():
    wb = Workbook()
    ws = wb.active
    for i in range(N):
        ws.append([i, f"name{i}", i * 2, i * 3, i * 4])
    wb.save("big_normal.xlsx")
    return f"{Path('big_normal.xlsx').stat().st_size / 1024 / 1024:.1f} MB"


def write_only():
    wb = Workbook(write_only=True)
    ws = wb.create_sheet()
    for i in range(N):
        ws.append([i, f"name{i}", i * 2, i * 3, i * 4])
    wb.save("big_write_only.xlsx")
    return f"{Path('big_write_only.xlsx').stat().st_size / 1024 / 1024:.1f} MB"


def read_normal():
    wb = load_workbook("big_write_only.xlsx")
    ws = wb.active
    return sum(row[2] for row in ws.iter_rows(values_only=True))


def read_only():
    wb = load_workbook("big_write_only.xlsx", read_only=True)
    ws = wb.active
    total = sum(row[2] for row in ws.iter_rows(values_only=True))
    wb.close()
    return total


measure("書き込み（通常）", write_normal)
measure("書き込み（write_only）", write_only)
measure("読み込み（通常）", read_normal)
measure("読み込み（read_only）", read_only)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #CE9178">&quot;&quot;&quot;通常モードと write_only / read_only の時間・メモリを比べる（10万行×5列）。&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> time</span></span>
<span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> tracemalloc</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> pathlib </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Path</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> openpyxl </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Workbook, load_workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">N = </span><span style="color: #B5CEA8">100_000</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">measure</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">label</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">func</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># 時間は tracemalloc なしで測る（tracemalloc を付けると遅くなるため）</span></span>
<span class="line"><span style="color: #D4D4D4">    t = time.perf_counter()</span></span>
<span class="line"><span style="color: #D4D4D4">    result = func()</span></span>
<span class="line"><span style="color: #D4D4D4">    sec = time.perf_counter() - t</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># メモリは別にもう一度動かして、Python が確保した量の最大値を見る</span></span>
<span class="line"><span style="color: #D4D4D4">    tracemalloc.start()</span></span>
<span class="line"><span style="color: #D4D4D4">    func()</span></span>
<span class="line"><span style="color: #D4D4D4">    peak = tracemalloc.get_traced_memory()[</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">] / </span><span style="color: #B5CEA8">1024</span><span style="color: #D4D4D4"> / </span><span style="color: #B5CEA8">1024</span></span>
<span class="line"><span style="color: #D4D4D4">    tracemalloc.stop()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">label</span><span style="color: #569CD6">}</span><span style="color: #CE9178">: </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">sec</span><span style="color: #569CD6">:.2f}</span><span style="color: #CE9178"> 秒 / 最大 </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">peak</span><span style="color: #569CD6">:.1f}</span><span style="color: #CE9178"> MB / </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">result</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">write_normal</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    wb = Workbook()</span></span>
<span class="line"><span style="color: #D4D4D4">    ws = wb.active</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> i </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">range</span><span style="color: #D4D4D4">(N):</span></span>
<span class="line"><span style="color: #D4D4D4">        ws.append([i, </span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;name</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">i</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">, i * </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">, i * </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">, i * </span><span style="color: #B5CEA8">4</span><span style="color: #D4D4D4">])</span></span>
<span class="line"><span style="color: #D4D4D4">    wb.save(</span><span style="color: #CE9178">&quot;big_normal.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">Path(</span><span style="color: #CE9178">&apos;big_normal.xlsx&apos;</span><span style="color: #D4D4D4">).stat().st_size / </span><span style="color: #B5CEA8">1024</span><span style="color: #D4D4D4"> / </span><span style="color: #B5CEA8">1024</span><span style="color: #569CD6">:.1f}</span><span style="color: #CE9178"> MB&quot;</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">write_only</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    wb = Workbook(</span><span style="color: #9CDCFE">write_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    ws = wb.create_sheet()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> i </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">range</span><span style="color: #D4D4D4">(N):</span></span>
<span class="line"><span style="color: #D4D4D4">        ws.append([i, </span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;name</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">i</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">, i * </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">, i * </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">, i * </span><span style="color: #B5CEA8">4</span><span style="color: #D4D4D4">])</span></span>
<span class="line"><span style="color: #D4D4D4">    wb.save(</span><span style="color: #CE9178">&quot;big_write_only.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">Path(</span><span style="color: #CE9178">&apos;big_write_only.xlsx&apos;</span><span style="color: #D4D4D4">).stat().st_size / </span><span style="color: #B5CEA8">1024</span><span style="color: #D4D4D4"> / </span><span style="color: #B5CEA8">1024</span><span style="color: #569CD6">:.1f}</span><span style="color: #CE9178"> MB&quot;</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_normal</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    wb = load_workbook(</span><span style="color: #CE9178">&quot;big_write_only.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    ws = wb.active</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">sum</span><span style="color: #D4D4D4">(row[</span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">] </span><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> row </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> ws.iter_rows(</span><span style="color: #9CDCFE">values_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">))</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_only</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    wb = load_workbook(</span><span style="color: #CE9178">&quot;big_write_only.xlsx&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">read_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    ws = wb.active</span></span>
<span class="line"><span style="color: #D4D4D4">    total = </span><span style="color: #DCDCAA">sum</span><span style="color: #D4D4D4">(row[</span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">] </span><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> row </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> ws.iter_rows(</span><span style="color: #9CDCFE">values_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">    wb.close()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> total</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">measure(</span><span style="color: #CE9178">&quot;書き込み（通常）&quot;</span><span style="color: #D4D4D4">, write_normal)</span></span>
<span class="line"><span style="color: #D4D4D4">measure(</span><span style="color: #CE9178">&quot;書き込み（write_only）&quot;</span><span style="color: #D4D4D4">, write_only)</span></span>
<span class="line"><span style="color: #D4D4D4">measure(</span><span style="color: #CE9178">&quot;読み込み（通常）&quot;</span><span style="color: #D4D4D4">, read_normal)</span></span>
<span class="line"><span style="color: #D4D4D4">measure(</span><span style="color: #CE9178">&quot;読み込み（read_only）&quot;</span><span style="color: #D4D4D4">, read_only)</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>処理</th><th>時間</th><th>メモリの最大値</th></tr></thead><tbody><tr><td>書き込み（通常）</td><td>1.95 秒</td><td>164.3 MB</td></tr><tr><td>書き込み（<code>write_only=True</code>）</td><td>1.62 秒</td><td>0.4 MB</td></tr><tr><td>読み込み（通常）</td><td>1.78 秒</td><td>188.2 MB</td></tr><tr><td>読み込み（<code>read_only=True</code>）</td><td>1.65 秒</td><td>8.5 MB</td></tr></tbody></table><figcaption class="wp-element-caption">10万行×5列、できたファイルはどちらも約3.0MB（macOS・Apple シリコン、2026年11月18日）</figcaption></figure>



<p class="wp-block-paragraph">時間の差は小さかったのですが、<strong>メモリは大きく減りました</strong>。ふつうのモードは全部のセルをメモリに持つので、行が増えるほどメモリを使います。大きなファイルでメモリが足りなくなるときは、この2つのモードを試してください。</p>



<h3 class="wp-block-heading">read_only の使い方と注意点</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>wb = load_workbook("big.xlsx", read_only=True)
ws = wb.active
for row in ws.iter_rows(values_only=True):
    ...
wb.close()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">wb = load_workbook(</span><span style="color: #CE9178">&quot;big.xlsx&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">read_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">ws = wb.active</span></span>
<span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> row </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> ws.iter_rows(</span><span style="color: #9CDCFE">values_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">wb.close()</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>read_only=True</code> で開いたシートには書き込めません。試すと次のエラーになりました。また、読み終わったら <code>wb.close()</code> でファイルを閉じます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>TypeError: 'ReadOnlyWorksheet' object does not support item assignment</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">TypeError: &apos;ReadOnlyWorksheet&apos; object does not support item assignment</span></span></code></pre></div>



<h3 class="wp-block-heading">write_only の使い方と注意点</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>wb = Workbook(write_only=True)
ws = wb.create_sheet()
for row in rows:
    ws.append(row)
wb.save("big.xlsx")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">wb = Workbook(</span><span style="color: #9CDCFE">write_only</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">ws = wb.create_sheet()</span></span>
<span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> row </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> rows:</span></span>
<span class="line"><span style="color: #D4D4D4">    ws.append(row)</span></span>
<span class="line"><span style="color: #D4D4D4">wb.save(</span><span style="color: #CE9178">&quot;big.xlsx&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>write_only=True</code> のブックは、確かめたところ次のような制限がありました。</p>



<figure class="wp-block-table"><table><thead><tr><th>やったこと</th><th>結果</th></tr></thead><tbody><tr><td><code>wb.active</code></td><td><code>None</code>（最初はシートがないので <code>create_sheet()</code> で作る）</td></tr><tr><td><code>ws["A1"] = "x"</code></td><td><code>TypeError: 'WriteOnlyWorksheet' object does not support item assignment</code></td></tr><tr><td>同じブックを2回 <code>save()</code></td><td>2回目は <code>FileNotFoundError</code> になった</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">書き込めるのは <code>append()</code> で上から順に1行ずつだけで、保存も1回きりです。全部の行を作り終えてから最後に1回だけ保存します。</p>



<h2 class="wp-block-heading">よくあるエラー</h2>



<h3 class="wp-block-heading">CSV は load_workbook で開けない</h3>



<p class="wp-block-paragraph"><code>load_workbook()</code> で CSV ファイルを開こうとすると、次のエラーになりました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>InvalidFileException: openpyxl does not support .csv file format, please check you can open it with Excel first. Supported formats are: .xlsx,.xlsm,.xltx,.xltm</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">InvalidFileException: openpyxl does not support .csv file format, please check you can open it with Excel first. Supported formats are: .xlsx,.xlsm,.xltx,.xltm</span></span></code></pre></div>



<p class="wp-block-paragraph">メッセージのとおり、openpyxl が扱えるのは .xlsx・.xlsm・.xltx・.xltm です。CSV は Python の <code>csv</code> モジュールや pandas で読み込みます。古い形式の .xls もこの対応形式の一覧にはありません（.xls は今回試していません）。</p>



<h3 class="wp-block-heading">ファイルが見つからない（FileNotFoundError）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>FileNotFoundError: [Errno 2] No such file or directory: 'nothing.xlsx'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">FileNotFoundError: [Errno 2] No such file or directory: &apos;nothing.xlsx&apos;</span></span></code></pre></div>



<p class="wp-block-paragraph">ファイル名は、スクリプトを実行したフォルダ（カレントディレクトリ）からの相対パスとして探されます。スクリプトと同じフォルダのファイルを開きたいときは、<a href="https://cfxlog.com/python-pathlib-guide/">pathlib</a> で <code>Path(__file__).parent / "sales.xlsx"</code> のように組み立てると確実です。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">openpyxl でよく使う書き方をまとめます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>作る：<code>Workbook()</code> → <code>ws.append()</code> / <code>ws["A1"] = ...</code> → <code>wb.save()</code></li>

<li>読む：<code>load_workbook()</code> → <code>ws.iter_rows(values_only=True)</code></li>

<li>シート：<code>create_sheet()</code>・<code>copy_worksheet()</code>・<code>remove()</code></li>

<li>数式：openpyxl は計算しない。<code>data_only=True</code> で開いたブックは保存しない</li>

<li>大きなファイル：<code>read_only=True</code> / <code>write_only=True</code> でメモリを減らす</li>
</ul>
</div></div>



<p class="wp-block-paragraph">書式やマクロをそのまま保ちたいファイルは、Excel 本体を操作する <a href="https://cfxlog.com/python-win32com-excel/">win32com</a> のほうが向いています。データの読み書きが中心なら、どの OS でも動く openpyxl から始めてみてください。</p>

]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>VBAでPDF出力する方法｜ExportAsFixedFormatと複数シート</title>
		<link>https://cfxlog.com/vba-pdf-export-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 25 Oct 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VBA]]></category>
		<category><![CDATA[Excel自動化]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/vba-pdf-export-guide/</guid>

					<description><![CDATA[ExportAsFixedFormatを使うと、Excelの印刷設定に沿ってPDFを作れます。保存先と印刷範囲を確認してから実行します。 VBA全体の学習順を確認したい場合は、Excel VBA入門ガイドから読めます。  [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ExcelのシートをVBAでPDFに保存したい</li>



<li>複数シートを1つのPDFにまとめたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ExportAsFixedFormatを使うと、Excelの印刷設定に沿ってPDFを作れます。保存先と印刷範囲を確認してから実行します。</p>



<p class="wp-block-paragraph">VBA全体の学習順を確認したい場合は、<a href="https://cfxlog.com/vba-guide/">Excel VBA入門ガイド</a>から読めます。</p>



<h2 class="wp-block-heading">全体像：どの方法を使うか</h2>



<p class="wp-block-paragraph">PDF出力の対象はシート1枚、ブック全体、選んだ複数シート、印刷範囲の4通りで考えます。先に何を1つのPDFにするか決めてから対象オブジェクトを選びます。</p>



<h3 class="wp-block-heading">目的から選ぶ</h3>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>1枚のシート：Worksheet.ExportAsFixedFormatを使う</li>



<li>ブック全体：Workbook.ExportAsFixedFormatを使う</li>



<li>任意の複数シート：一時ブックへコピーして出力する</li>



<li>セル範囲：PageSetup.PrintAreaを一時的に設定して出力する</li>
</ul>
</div></div>



<h2 class="wp-block-heading">1枚のシートをPDFにする</h2>



<h3 class="wp-block-heading">保存先フォルダとファイル名を決める</h3>



<p class="wp-block-paragraph">このブックと同じフォルダに、日付を付けたPDFを保存します。未保存のブックでは実行を止め、同名ファイルがある場合も上書きしない例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

Public Sub ExportSheetPdf()
    Dim outputPath As String
    If Len(ThisWorkbook.Path) = 0 Then
        MsgBox "先にブックを保存してください"
        Exit Sub
    End If
    outputPath = ThisWorkbook.Path &amp; Application.PathSeparator &amp; _
                 "報告書_" &amp; Format(Date, "yyyymmdd") &amp; ".pdf"
    If Len(Dir(outputPath)) > 0 Then
        MsgBox "同名のPDFがあります: " &amp; outputPath
        Exit Sub
    End If
    Sheet1.ExportAsFixedFormat Type:=xlTypePDF, Filename:=outputPath, _
        Quality:=xlQualityStandard, IgnorePrintAreas:=False, _
        OpenAfterPublish:=False
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">ExportSheetPdf</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4">) = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;先にブックを保存してください&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #4EC9B0">Application</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">PathSeparator</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">                 </span><span style="color: #CE9178">&quot;報告書_&quot;</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">Format</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Date</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;yyyymmdd&quot;</span><span style="color: #D4D4D4">) &amp; </span><span style="color: #CE9178">&quot;.pdf&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">)) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;同名のPDFがあります: &quot;</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> outputPath</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #D4D4D4">    Sheet1.ExportAsFixedFormat Type:=</span><span style="color: #9CDCFE">xlTypePDF</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> Filename</span><span style="color: #D4D4D4">:=</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">        Quality:=</span><span style="color: #9CDCFE">xlQualityStandard</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> IgnorePrintAreas</span><span style="color: #D4D4D4">:=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">        OpenAfterPublish:=</span><span style="color: #569CD6">False</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">OpenAfterPublish:=Trueにすると作成後にPDFを開きます。自動処理ではFalseにして、必要に応じて確認すると扱いやすいです。</p>



<h3 class="wp-block-heading">印刷範囲と改ページを確認する</h3>



<p class="wp-block-paragraph">IgnorePrintAreas:=Falseは設定済みの印刷範囲を使います。余白、拡大縮小、改ページでPDFのページ割りが変わるため、Excelの印刷プレビューで先に確認します。</p>



<h2 class="wp-block-heading">ブック全体・複数シートを出力する</h2>



<h3 class="wp-block-heading">ブック全体と任意の複数シート</h3>



<p class="wp-block-paragraph">ブック全体ならThisWorkbook.ExportAsFixedFormatを使います。次の例はSheet1とSheet2を一時ブックにコピーして、1つのPDFにします。元のブックのシートは変更しません。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

Public Sub ExportWorkbookPdf()
    Dim outputPath As String
    If Len(ThisWorkbook.Path) = 0 Then Exit Sub
    outputPath = ThisWorkbook.Path &amp; Application.PathSeparator &amp; "ブック全体.pdf"
    If Len(Dir(outputPath)) > 0 Then Exit Sub
    ThisWorkbook.ExportAsFixedFormat Type:=xlTypePDF, Filename:=outputPath, _
        IgnorePrintAreas:=False, OpenAfterPublish:=False
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">ExportWorkbookPdf</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4">) = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #4EC9B0">Application</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">PathSeparator</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;ブック全体.pdf&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">)) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    ThisWorkbook.ExportAsFixedFormat Type:=</span><span style="color: #9CDCFE">xlTypePDF</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> Filename</span><span style="color: #D4D4D4">:=</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">        IgnorePrintAreas:=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> OpenAfterPublish</span><span style="color: #D4D4D4">:=</span><span style="color: #569CD6">False</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">ブック全体を出す場合は、非表示シートや各シートの印刷設定も事前に確認します。任意の2枚だけに絞る場合は次の例を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

Public Sub ExportTwoSheetsPdf()
    Dim tempBook As Workbook
    Dim outputPath As String
    If Len(ThisWorkbook.Path) = 0 Then Exit Sub
    outputPath = ThisWorkbook.Path &amp; Application.PathSeparator &amp; _
                 "2シート_" &amp; Format(Date, "yyyymmdd") &amp; ".pdf"
    If Len(Dir(outputPath)) > 0 Then Exit Sub
    On Error GoTo CleanUp
    ThisWorkbook.Worksheets(Array(Sheet1.Name, Sheet2.Name)).Copy
    Set tempBook = ActiveWorkbook
    tempBook.ExportAsFixedFormat Type:=xlTypePDF, Filename:=outputPath, _
        IgnorePrintAreas:=False, OpenAfterPublish:=False
CleanUp:
    If Not tempBook Is Nothing Then tempBook.Close SaveChanges:=False
    If Err.Number &lt;> 0 Then MsgBox Err.Description
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">ExportTwoSheetsPdf</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> tempBook </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Workbook</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4">) = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #4EC9B0">Application</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">PathSeparator</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">                 </span><span style="color: #CE9178">&quot;2シート_&quot;</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">Format</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Date</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;yyyymmdd&quot;</span><span style="color: #D4D4D4">) &amp; </span><span style="color: #CE9178">&quot;.pdf&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">)) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">On Error GoTo </span><span style="color: #D4D4D4">CleanUp</span></span>
<span class="line"><span style="color: #D4D4D4">    ThisWorkbook.</span><span style="color: #DCDCAA">Worksheets</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Array</span><span style="color: #D4D4D4">(Sheet1.Name, Sheet2.</span><span style="color: #9CDCFE">Name</span><span style="color: #D4D4D4">)).Copy</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">tempBook</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> ActiveWorkbook</span></span>
<span class="line"><span style="color: #D4D4D4">    tempBook.ExportAsFixedFormat Type:=</span><span style="color: #9CDCFE">xlTypePDF</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> Filename</span><span style="color: #D4D4D4">:=</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">        IgnorePrintAreas:=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> OpenAfterPublish</span><span style="color: #D4D4D4">:=</span><span style="color: #569CD6">False</span></span>
<span class="line"><span style="color: #D4D4D4">CleanUp:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> Not tempBook Is</span><span style="color: #569CD6"> Nothing</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> tempBook.Close SaveChanges:=</span><span style="color: #569CD6">False</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> Err.</span><span style="color: #9CDCFE">Number</span><span style="color: #D4D4D4"> &lt;&gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> Err.Description</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">シートのCodeNameがSheet1・Sheet2のブックで使う例です。PDF出力後は一時ブックを閉じます。全シートを出すときはThisWorkbookを対象にしてください。</p>



<h3 class="wp-block-heading">セル範囲だけをPDFにしたい場合</h3>



<p class="wp-block-paragraph">RangeにはExportAsFixedFormatがありません。対象シートのPageSetup.PrintAreaを一時的に指定してシートを出力し、元の印刷範囲へ戻します。次はSheet1のA1:C20だけを印刷範囲にする例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

Public Sub ExportRangePdf()
    Dim oldArea As String
    Dim outputPath As String
    Dim errorText As String
    If Len(ThisWorkbook.Path) = 0 Then Exit Sub
    outputPath = ThisWorkbook.Path &amp; Application.PathSeparator &amp; "指定範囲.pdf"
    If Len(Dir(outputPath)) > 0 Then Exit Sub
    oldArea = Sheet1.PageSetup.PrintArea
    On Error GoTo RestoreArea
    Sheet1.PageSetup.PrintArea = Sheet1.Range("A1:C20").Address
    Sheet1.ExportAsFixedFormat Type:=xlTypePDF, Filename:=outputPath, _
        IgnorePrintAreas:=False, OpenAfterPublish:=False
RestoreArea:
    If Err.Number &lt;> 0 Then errorText = Err.Description
    Sheet1.PageSetup.PrintArea = oldArea
    If Len(errorText) > 0 Then MsgBox errorText
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">ExportRangePdf</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> oldArea </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> errorText </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4">) = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #4EC9B0">Application</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">PathSeparator</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;指定範囲.pdf&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">)) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">oldArea</span><span style="color: #D4D4D4"> = Sheet1.PageSetup.PrintArea</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">On Error GoTo </span><span style="color: #D4D4D4">RestoreArea</span></span>
<span class="line"><span style="color: #D4D4D4">    Sheet1.PageSetup.</span><span style="color: #9CDCFE">PrintArea</span><span style="color: #D4D4D4"> = Sheet1.</span><span style="color: #DCDCAA">Range</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;A1:C20&quot;</span><span style="color: #D4D4D4">).Address</span></span>
<span class="line"><span style="color: #D4D4D4">    Sheet1.ExportAsFixedFormat Type:=</span><span style="color: #9CDCFE">xlTypePDF</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> Filename</span><span style="color: #D4D4D4">:=</span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">        IgnorePrintAreas:=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> OpenAfterPublish</span><span style="color: #D4D4D4">:=</span><span style="color: #569CD6">False</span></span>
<span class="line"><span style="color: #D4D4D4">RestoreArea:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> Err.</span><span style="color: #9CDCFE">Number</span><span style="color: #D4D4D4"> &lt;&gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">errorText</span><span style="color: #D4D4D4"> = Err.Description</span></span>
<span class="line"><span style="color: #D4D4D4">    Sheet1.PageSetup.</span><span style="color: #9CDCFE">PrintArea</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> oldArea</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">errorText</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> errorText</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">印刷範囲の変更を伴うため、コピーしたブックで先に試してください。元の印刷範囲はPDF出力後に戻します。</p>



<h2 class="wp-block-heading">実務例：日付入りの報告書を保存する</h2>



<h3 class="wp-block-heading">保存前に確認する3点</h3>



<p class="wp-block-paragraph">毎日作る帳票なら、保存先、同名ファイル、印刷設定を先に確認します。ブックを保存していない場合はThisWorkbook.Pathが空になるため、そのままファイル名を組み立てないようにします。</p>



<p class="wp-block-paragraph">日付だけのファイル名は同じ日に再実行すると衝突します。例のSubは同名PDFがあれば中断するので、上書きが必要なら別名へ変更するか、既存ファイルの扱いを決めてください。</p>



<p class="wp-block-paragraph">PDFの中身はExcelの印刷設定に左右されます。セルの見た目だけで判断せず、印刷プレビューで横幅、余白、改ページ、ページ番号を確認します。</p>



<h3 class="wp-block-heading">出力範囲とページ割り</h3>



<p class="wp-block-paragraph">表の一部だけを出す場合はPrintAreaを指定します。IgnorePrintAreas:=Falseなら設定した範囲を使い、Trueなら印刷範囲の設定を無視します。</p>



<p class="wp-block-paragraph">ページが途中で切れる場合は、用紙方向や拡大縮小、手動の改ページを確認します。VBAでPDFを出す前に、Excel上で望むページ割りにしておくと切り分けやすくなります。</p>



<p class="wp-block-paragraph">複数シートを1つのPDFにする場合、それぞれのシートが持つ印刷設定の影響を受けます。1枚目だけ設定を整えても、2枚目の余白や用紙サイズが違えば見え方が揃いません。</p>



<p class="wp-block-paragraph">出力前にはプレビューのページ数も見ます。予定より多い場合は印刷範囲と改ページを見直し、少ない場合は非表示の行・列やシートが対象から外れていないかを確認します。</p>



<p class="wp-block-paragraph">報告書の体裁を揃えるなら、ページごとに同じ用紙サイズ、向き、余白を設定します。Excelの画面では隣り合うセルでも、PDFではページ境界で分かれることがあります。</p>



<h3 class="wp-block-heading">一時ブックでシートをまとめる理由</h3>



<p class="wp-block-paragraph">任意の複数シートだけをPDFにしたい場合、選択状態に依存する操作より、一時ブックへ対象シートをコピーする流れの方が対象が明示されます。元ブックは閉じず、一時ブックだけを保存せずに閉じます。</p>



<p class="wp-block-paragraph">ただしシート間の数式や外部参照は、コピーした一時ブックでも期待どおりに表示されるか確認が必要です。元ブック上の印刷プレビューと、できあがったPDFの両方を比べてください。</p>



<p class="wp-block-paragraph">保存したPDFをメールで送る作業まで続ける場合は、保存が成功したこととファイル名が正しいことを確認してから添付します。日付が変わる時刻に処理すると、作成時と添付時のファイル名が食い違う可能性があるため、決めたoutputPathを次の処理へ渡します。</p>



<p class="wp-block-paragraph">PDFをOutlookメールに添付する手順は、<a href="https://cfxlog.com/vba-outlook-mail-send/">VBAでOutlookメールを作成する方法</a>で確認できます。</p>



<h2 class="wp-block-heading">よくあるエラーと対処</h2>



<h3 class="wp-block-heading">保存先のフォルダが存在しない</h3>



<p class="wp-block-paragraph">Filenameに存在しないフォルダを含めると保存に失敗します。例ではThisWorkbook.Pathを使い、ブックが保存済みかを先に確認しています。別の保存先を使うなら、そのフォルダの存在と書き込み権限も確認します。</p>



<h3 class="wp-block-heading">同名のPDFがすでにある</h3>



<p class="wp-block-paragraph">日付だけのファイル名は同日に再実行すると重なります。既存PDFを黙って置き換えない方針ならDirで確認して中断し、日時や連番を使う方針なら命名規則を決めます。</p>



<h3 class="wp-block-heading">空白ページや想定外の改ページが入る</h3>



<p class="wp-block-paragraph">印刷範囲が広すぎたり、遠いセルに書式だけ残っていたりすると、PDFに余分なページが出ることがあります。印刷プレビューで範囲を確かめ、必要ならPrintAreaを狭めます。</p>



<p class="wp-block-paragraph">横長の表が右側だけ別ページへ分かれる場合は、用紙方向、拡大縮小、列幅を確認します。コードを変える前に印刷設定が意図どおりかを調べます。</p>



<h2 class="wp-block-heading">よくある質問</h2>



<h3 class="wp-block-heading">OpenAfterPublishをTrueにするべきですか？</h3>



<p class="wp-block-paragraph">その場で作成結果を確認したいならTrueが便利です。複数件を自動で出す処理ならPDFが次々開くため、Falseにして必要なファイルだけ確認する方が扱いやすくなります。</p>



<h3 class="wp-block-heading">複数シートは1つのPDFになりますか？</h3>



<p class="wp-block-paragraph">例では対象シートを一時ブックにコピーし、その一時ブックをExportAsFixedFormatで出力します。出力前にシートの順序と各シートの印刷設定を確かめます。</p>



<h3 class="wp-block-heading">セル範囲へ直接ExportAsFixedFormatを呼べますか？</h3>



<p class="wp-block-paragraph">例で使うのはWorksheetまたはWorkbookのメソッドです。セル範囲を対象にする場合はPrintAreaへ範囲を指定し、出力後に元の値へ戻します。</p>



<h3 class="wp-block-heading">既存のPDFを結合したい場合は？</h3>



<p class="wp-block-paragraph">Excelの複数シートを同時に出す場合と、すでにある別々のPDFを結合する場合は作業が違います。後者はpypdfで結合する方法もあります。</p>



<h3 class="wp-block-heading">ファイル名に時刻も付けられますか？</h3>



<p class="wp-block-paragraph">Format(Now, &#8220;yyyymmdd_hhnnss&#8221;)のように日時を組み立てられます。ただし複数処理が同じ秒に走る可能性は残るため、上書きしたくないなら存在確認も続けます。</p>



<h2 class="wp-block-heading">まとめ：対象と印刷設定を決めてから出力する</h2>



<p class="wp-block-paragraph">1枚のシート、ブック全体、任意の複数シートでは、ExportAsFixedFormatを呼ぶ対象が変わります。セル範囲を出すときはPrintAreaを一時的に設定します。</p>



<p class="wp-block-paragraph">保存前にフォルダと同名ファイルを確認し、印刷プレビューでページ割りを調べます。PDF作成後は実際のファイルを開き、内容を目で確認してください。</p>



<h2 class="wp-block-heading">関連記事</h2>



<h3 class="wp-block-heading">あわせて読みたい記事</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-outlook-mail-send/">VBAでOutlookメールを作成・送信する方法｜差し込みと添付を安全に確認</a>
						<span class="p-blogCard__excerpt">Excelの一覧からOutlookメールの下書きを作りたい 添付や差し込みを行い、送信前に内容を確認したい まずDisplayで下書きを開き、宛先と本文を目で確かめます。Sendは確&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/08/vba-file-csv-guide-300x158.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-file-csv-guide/">【VBA】ファイル・CSV操作完全ガイド｜出力・文字コード・フォルダ操作をまとめて解説</a>
						<span class="p-blogCard__excerpt">VBAでテストを回していた頃、結果を手作業でコピーして残すのが面倒で、必ずCSVに書き出してバックアップするようにしていた。 手作業だとうっかり上書きしてしまうこと&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-pypdf-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-pypdf-guide/">pypdfの使い方｜インストール・テキスト抽出・結合・分割を解説</a>
						<span class="p-blogCard__excerpt">Python で PDF を扱いたい！ テキスト抽出・結合・分割を自動化したい！ PyPDF と PyPDF2 の違いが知りたい！ PyPDF2 の古いコードを pypdf に書き換えたい！ このよう&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-guide/">Excel VBA完全入門ガイド｜マクロの基礎から実践まで全ステップ解説</a>
						<span class="p-blogCard__excerpt">VBAって何？マクロとどう違うの？ VBAを始めたいけど、何から手をつければいいかわからない Excelの繰り返し作業を自動化して、残業を減らしたい このような疑問にお答&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>VBAシート・ブック完全ガイド｜安全に開く・保護する・閉じるまでの一連の流れ</title>
		<link>https://cfxlog.com/vba-workbook-sheet-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 18 Aug 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[VBA]]></category>
		<category><![CDATA[Excel自動化]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/vba-workbook-sheet-guide/</guid>

					<description><![CDATA[外部ブックを開いて、値を読み取って、閉じる。それだけのマクロのつもりだった。 ところが後日、タスクマネージャーを開いたらExcel.exeがいくつも残っていた。マクロを実行するたびに、閉じたつもりのブックが裏でプロセスと [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">外部ブックを開いて、値を読み取って、閉じる。それだけのマクロのつもりだった。</p>



<p class="wp-block-paragraph">ところが後日、タスクマネージャーを開いたらExcel.exeがいくつも残っていた。マクロを実行するたびに、閉じたつもりのブックが裏でプロセスとして生き続けていたようだ。</p>



<p class="wp-block-paragraph">原因は単純で、開いたブックをきちんとCloseしていなかっただけ。ただ、「開く」「操作する」「保護する」「閉じる」という一連の流れを最初にセットで押さえていれば、そもそも起きなかったミスでもある。</p>



<p class="wp-block-paragraph">この記事では、<strong>Workbook・Worksheetを安全に開いて、操作して、保護して、閉じるまでの一連の流れ</strong>をまとめました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-guide/">Excel VBA完全入門ガイド｜マクロの基礎から実践まで全ステップ解説</a>
						<span class="p-blogCard__excerpt">VBAって何？マクロとどう違うの？ VBAを始めたいけど、何から手をつければいいかわからない Excelの繰り返し作業を自動化して、残業を減らしたい このような疑問にお答&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">ブック・シート操作の全体像</h2>



<p class="wp-block-paragraph">ブックを扱うマクロは、だいたい次の4フェーズで構成されます。まずは全体を俯瞰してから、各フェーズを詳しく見ていきます。</p>



<figure class="wp-block-table"><table><thead><tr><th>フェーズ</th><th>主な処理</th></tr></thead><tbody><tr><td>開く</td><td>存在確認・多重オープンチェック・読み取り専用/パスワード対応</td></tr><tr><td>シートを操作する</td><td>参照・存在確認・追加/削除・アクティブ化</td></tr><tr><td>保護する</td><td>シート全体の保護、特定範囲だけ編集可にする</td></tr><tr><td>閉じる</td><td>保存有無の制御、Excelプロセスを残さない</td></tr></tbody></table></figure>



<h2 class="wp-block-heading">ブックを安全に開く</h2>



<h3 class="wp-block-heading">最短コードで開く</h3>



<p class="wp-block-paragraph">まずは一番シンプルな形です。パスが確実に存在するとわかっている、動作確認段階で使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub OpenBook_Min()
    Workbooks.Open "C:\Data\Book1.xlsx"
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> OpenBook_Min</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#D4D4D4">    Workbooks.Open </span><span style="color:#CE9178">"C:\Data\Book1.xlsx"</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">ただし、このままだとファイルが存在しない場合や、同名ブックがすでに開いている場合にエラーで止まります。実務で配布するマクロには、もう一段のチェックが必要です。</p>



<h3 class="wp-block-heading">存在確認と多重オープンチェックをセットで行う</h3>



<p class="wp-block-paragraph">Excelは同名ブックを同時に開けない仕様です。<code>Dir</code>関数でファイルの存在を、<code>Workbooks</code>コレクションのループで開き済みかどうかを、それぞれ確認してから開きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub OpenBook_Safely()
    Const TARGET As String = "C:\Data\Book1.xlsx"
    Dim fileName As String
    Dim wb As Workbook

    If Dir(TARGET) = "" Then
        MsgBox "ファイルが見つかりません: " &amp; TARGET, vbExclamation
        Exit Sub
    End If

    fileName = Dir(TARGET)
    For Each wb In Workbooks
        If wb.Name = fileName Then
            MsgBox fileName &amp; " は既に開いています。", vbExclamation
            Exit Sub
        End If
    Next wb

    Workbooks.Open Filename:=TARGET
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> OpenBook_Safely</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Const </span><span style="color:#D4D4D4">TARGET As </span><span style="color:#4EC9B0">String</span><span style="color:#D4D4D4"> = </span><span style="color:#CE9178">"C:\Data\Book1.xlsx"</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> fileName </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">String</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">    If</span><span style="color:#DCDCAA"> Dir</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">TARGET</span><span style="color:#D4D4D4">) = </span><span style="color:#CE9178">""</span><span style="color:#C586C0"> Then</span></span>
<span class="line"><span style="color:#DCDCAA">        MsgBox</span><span style="color:#CE9178"> "ファイルが見つかりません: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> TARGET</span><span style="color:#D4D4D4">,</span><span style="color:#9CDCFE"> vbExclamation</span></span>
<span class="line"><span style="color:#C586C0">        Exit Sub</span></span>
<span class="line"><span style="color:#C586C0">    End If</span></span>
<span class="line"></span>
<span class="line"><span style="color:#9CDCFE">    fileName</span><span style="color:#D4D4D4"> = </span><span style="color:#DCDCAA">Dir</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">TARGET</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#C586C0">    For</span><span style="color:#C586C0"> Each</span><span style="color:#D4D4D4"> wb In Workbooks</span></span>
<span class="line"><span style="color:#C586C0">        If</span><span style="color:#D4D4D4"> wb.</span><span style="color:#9CDCFE">Name</span><span style="color:#D4D4D4"> =</span><span style="color:#9CDCFE"> fileName</span><span style="color:#C586C0"> Then</span></span>
<span class="line"><span style="color:#DCDCAA">            MsgBox</span><span style="color:#9CDCFE"> fileName</span><span style="color:#D4D4D4"> &amp; </span><span style="color:#CE9178">" は既に開いています。"</span><span style="color:#D4D4D4">,</span><span style="color:#9CDCFE"> vbExclamation</span></span>
<span class="line"><span style="color:#C586C0">            Exit Sub</span></span>
<span class="line"><span style="color:#C586C0">        End If</span></span>
<span class="line"><span style="color:#C586C0">    Next</span><span style="color:#D4D4D4"> wb</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    Workbooks.Open Filename:=</span><span style="color:#9CDCFE">TARGET</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">この2つのチェックだけで、実務でよく起きるエラーの大半は防げます。</p>



<h3 class="wp-block-heading">パスが決まっていないときはダイアログで選ばせる</h3>



<p class="wp-block-paragraph">対象ファイルのパスを固定できない場合は、ユーザーに選んでもらうのが安全です。戻り値は選択パス（文字列）か、キャンセル時の<code>False</code>のどちらかになります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub OpenBook_PickDialog()
    Dim filePath As Variant
    filePath = Application.GetOpenFilename("Excelブック,*.xls?")

    If VarType(filePath) = vbBoolean Then Exit Sub ' キャンセル

    Workbooks.Open Filename:=CStr(filePath)
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> OpenBook_PickDialog</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> filePath </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Variant</span></span>
<span class="line"><span style="color:#9CDCFE">    filePath</span><span style="color:#D4D4D4"> = </span><span style="color:#4EC9B0">Application</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">GetOpenFilename</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"Excelブック,*.xls?"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">    If</span><span style="color:#DCDCAA"> VarType</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">filePath</span><span style="color:#D4D4D4">) =</span><span style="color:#9CDCFE"> vbBoolean</span><span style="color:#C586C0"> Then</span><span style="color:#C586C0"> Exit Sub</span><span style="color:#6A9955"> ' キャンセル</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    Workbooks.Open Filename:=</span><span style="color:#DCDCAA">CStr</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">filePath</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<h3 class="wp-block-heading">読み取り専用・パスワード付きで開く</h3>



<p class="wp-block-paragraph">参照専用のブックには<code>ReadOnly:=True</code>を、パスワード保護されたブックには<code>Password:=</code>を指定します。実務ではこの2つを組み合わせたテンプレをよく使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub OpenBook_ReadOnlyWithPassword()
    Dim wb As Workbook
    Set wb = Workbooks.Open( _
        Filename:="C:\Data\Book1.xlsx", _
        ReadOnly:=True, _
        Password:="secret123")
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> OpenBook_ReadOnlyWithPassword</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> = Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE"> _</span></span>
<span class="line"><span style="color:#D4D4D4">        Filename:=</span><span style="color:#CE9178">"C:\Data\Book1.xlsx"</span><span style="color:#D4D4D4">,</span><span style="color:#9CDCFE"> _</span></span>
<span class="line"><span style="color:#D4D4D4">        ReadOnly:=</span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">,</span><span style="color:#9CDCFE"> _</span></span>
<span class="line"><span style="color:#D4D4D4">        Password:=</span><span style="color:#CE9178">"secret123"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">パスワードが不要なファイルに<code>Password:=</code>を渡しても無視されるだけなので、両方の引数を常にセットで書いておいても実害はありません。</p>



<h2 class="wp-block-heading">Worksheetの基本操作</h2>



<h3 class="wp-block-heading">シートを名前で参照する</h3>



<p class="wp-block-paragraph">シートは名前とインデックスのどちらでも参照できますが、インデックス指定はシートの並び順が変わると別のシートを指してしまいます。基本的には名前で参照するようにしています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub ReferSheet()
    Dim wsByName As Worksheet
    Set wsByName = ThisWorkbook.Worksheets("売上")

    ' 並び順に依存するため、シートが増減する運用では避けたい
    Dim wsByIndex As Worksheet
    Set wsByIndex = ThisWorkbook.Worksheets(1)
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ReferSheet</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wsByName </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Worksheet</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wsByName</span><span style="color:#D4D4D4"> = ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"売上"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 並び順に依存するため、シートが増減する運用では避けたい</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wsByIndex </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Worksheet</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wsByIndex</span><span style="color:#D4D4D4"> = ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<h3 class="wp-block-heading">シートの存在確認</h3>



<p class="wp-block-paragraph">存在しないシート名を指定するとエラーになります。<code>On Error Resume Next</code>で一時的にエラーを無視し、変数に代入できたかどうかで判定するのが定番です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Function SheetExists(sheetName As String) As Boolean
    Dim ws As Worksheet
    On Error Resume Next
    Set ws = ThisWorkbook.Worksheets(sheetName)
    On Error GoTo 0
    SheetExists = Not ws Is Nothing
End Function</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Function</span><span style="color:#DCDCAA"> SheetExists</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">sheetName As String</span><span style="color:#D4D4D4">) As Boolean</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> ws </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Worksheet</span></span>
<span class="line"><span style="color:#569CD6">    On Error Resume Next</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">ws</span><span style="color:#D4D4D4"> = ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">sheetName</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#569CD6">    On Error GoTo </span><span style="color:#B5CEA8">0</span></span>
<span class="line"><span style="color:#9CDCFE">    SheetExists</span><span style="color:#D4D4D4"> =</span><span style="color:#9CDCFE"> Not</span><span style="color:#D4D4D4"> ws Is</span><span style="color:#569CD6"> Nothing</span></span>
<span class="line"><span style="color:#569CD6">End Function</span></span></code></pre></div>



<h3 class="wp-block-heading">シートを追加・削除する</h3>



<p class="wp-block-paragraph">シートを削除するとき、Excelは確認ダイアログを出します。マクロの中で完結させたい場合は<code>Application.DisplayAlerts</code>を一時的にFalseにします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub AddAndDeleteSheet()
    Dim ws As Worksheet

    ' 末尾に追加
    Set ws = ThisWorkbook.Worksheets.Add( _
        After:=ThisWorkbook.Worksheets(ThisWorkbook.Worksheets.Count))
    ws.Name = "作業用"

    ' 確認ダイアログを出さずに削除
    Application.DisplayAlerts = False
    ThisWorkbook.Worksheets("作業用").Delete
    Application.DisplayAlerts = True
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> AddAndDeleteSheet</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> ws </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Worksheet</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 末尾に追加</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">ws</span><span style="color:#D4D4D4"> = ThisWorkbook.Worksheets.</span><span style="color:#DCDCAA">Add</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE"> _</span></span>
<span class="line"><span style="color:#D4D4D4">        After:=ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(ThisWorkbook.Worksheets.</span><span style="color:#9CDCFE">Count</span><span style="color:#D4D4D4">))</span></span>
<span class="line"><span style="color:#D4D4D4">    ws.</span><span style="color:#9CDCFE">Name</span><span style="color:#D4D4D4"> = </span><span style="color:#CE9178">"作業用"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 確認ダイアログを出さずに削除</span></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">DisplayAlerts</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> False</span></span>
<span class="line"><span style="color:#D4D4D4">    ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"作業用"</span><span style="color:#D4D4D4">).Delete</span></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">DisplayAlerts</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> True</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">地味に見落としがちですが、<code>DisplayAlerts</code>をTrueに戻し忘れると、以降の処理で別の確認ダイアログまで無言でスキップされてしまいます。必ずセットで書いてください。</p>



<h3 class="wp-block-heading">アクティブシートを切り替える</h3>



<p class="wp-block-paragraph">ユーザーの画面上で見せたいシートを切り替えるときは<code>Activate</code>を使います。裏側でデータを処理するだけなら、アクティブ化せずシートを直接指定して操作するほうが速く、画面のちらつきも防げます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub ActivateSheet()
    ThisWorkbook.Worksheets("集計").Activate
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ActivateSheet</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#D4D4D4">    ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"集計"</span><span style="color:#D4D4D4">).Activate</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<h2 class="wp-block-heading">Protect/Unprotectでシートを保護する</h2>



<p class="wp-block-paragraph">自分の作業用マクロでは保護をかけることはあまりありません。ただ、お客様に配布するツールでは「入力欄以外を誤って書き換えられたくない」という要望で保護をかけることが多いです。</p>



<h3 class="wp-block-heading">シート全体を保護する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub ProtectWholeSheet()
    ThisWorkbook.Worksheets("集計").Protect Password:="pass1234"
End Sub

Sub UnprotectWholeSheet()
    ThisWorkbook.Worksheets("集計").Unprotect Password:="pass1234"
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ProtectWholeSheet</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#D4D4D4">    ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"集計"</span><span style="color:#D4D4D4">).Protect Password:=</span><span style="color:#CE9178">"pass1234"</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> UnprotectWholeSheet</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#D4D4D4">    ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"集計"</span><span style="color:#D4D4D4">).Unprotect Password:=</span><span style="color:#CE9178">"pass1234"</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<h3 class="wp-block-heading">特定範囲だけ編集可能にする</h3>



<p class="wp-block-paragraph">セルには初期状態でLockedプロパティがTrueに設定されています。保護をかけると全セルがロックされる仕組みなので、入力してほしい範囲だけ先にロックを外しておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub ProtectExceptInputRange()
    Dim ws As Worksheet
    Set ws = ThisWorkbook.Worksheets("入力フォーム")

    ' 全セルを一旦ロック状態にする
    ws.Cells.Locked = True

    ' 入力してほしい範囲だけロック解除
    ws.Range("C3:C10").Locked = False

    ws.Protect Password:="pass1234"
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ProtectExceptInputRange</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> ws </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Worksheet</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">ws</span><span style="color:#D4D4D4"> = ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"入力フォーム"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 全セルを一旦ロック状態にする</span></span>
<span class="line"><span style="color:#D4D4D4">    ws.Cells.</span><span style="color:#9CDCFE">Locked</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> True</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 入力してほしい範囲だけロック解除</span></span>
<span class="line"><span style="color:#D4D4D4">    ws.</span><span style="color:#DCDCAA">Range</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C3:C10"</span><span style="color:#D4D4D4">).</span><span style="color:#9CDCFE">Locked</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> False</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    ws.Protect Password:=</span><span style="color:#CE9178">"pass1234"</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">新規シートのセルは初期状態でLockedがTrueなので、「入力範囲だけFalseにする」という引き算の発想で組むとミスが減ります。</p>



<h3 class="wp-block-heading">VBAからは書き込みたいのに保護もしたい場合</h3>



<p class="wp-block-paragraph">保護をかけたシートに対して、マクロ側からセルを書き換えようとすると実行時エラー1004になります。都度Unprotect・Protectし直すのは面倒ですし、処理の途中で止まるとProtectし忘れるリスクもあります。</p>



<p class="wp-block-paragraph">こういう場面では、<code>UserInterfaceOnly:=True</code>を付けて保護すると、<strong>ユーザーの手入力だけをブロックし、VBAからの書き込みは許可する</strong>状態にできます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub ProtectButAllowVBA()
    ThisWorkbook.Worksheets("集計").Protect _
        Password:="pass1234", UserInterfaceOnly:=True
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ProtectButAllowVBA</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#D4D4D4">    ThisWorkbook.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"集計"</span><span style="color:#D4D4D4">).Protect _</span></span>
<span class="line"><span style="color:#D4D4D4">        Password:=</span><span style="color:#CE9178">"pass1234"</span><span style="color:#D4D4D4">,</span><span style="color:#9CDCFE"> UserInterfaceOnly</span><span style="color:#D4D4D4">:=</span><span style="color:#569CD6">True</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">ただし、この設定はブックを閉じると引き継がれません。<code>Workbook_Open</code>イベントで毎回Protectし直す運用が必要です。知らないと「昨日まで書き込めていたのに今日はエラーになる」という現象に遭遇します。</p>



<h3 class="wp-block-heading">パスワードは万能ではないと理解しておく</h3>



<p class="wp-block-paragraph">シート保護のパスワードは、あくまで「誤操作の防止」レベルの保護です。解析ツールで突破できることが知られているので、本当に見られたくないデータの保護には向きません。</p>



<p class="wp-block-paragraph">お客様から「絶対に触られたくない」と言われた場合は、パスワード保護だけで完結させず、そもそも別ファイルに分離するなどの運用面での対策もあわせて提案するようにしています。</p>



<h2 class="wp-block-heading">開いたら閉じる — プロセス残留を防ぐ</h2>



<p class="wp-block-paragraph">冒頭の話の通り、開いたブックを閉じ忘れると、画面上は見えないままExcelプロセスだけが残り続けます。開いて処理して閉じる、という一連の流れをワンセットで書くくせをつけておくと防げます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub ProcessAndClose()
    Dim wb As Workbook
    Set wb = Workbooks.Open("C:\Data\Book1.xlsx")

    ' ここで読み取り・書き込みなどの処理
    Debug.Print wb.Worksheets(1).Range("A1").Value

    wb.Close SaveChanges:=False
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ProcessAndClose</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> = Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C:\Data\Book1.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' ここで読み取り・書き込みなどの処理</span></span>
<span class="line"><span style="color:#D4D4D4">    Debug.Print wb.</span><span style="color:#DCDCAA">Worksheets</span><span style="color:#D4D4D4">(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">).</span><span style="color:#DCDCAA">Range</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"A1"</span><span style="color:#D4D4D4">).Value</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    wb.Close SaveChanges:=</span><span style="color:#569CD6">False</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">保存の有無を制御する引数や、Excelアプリケーション自体を終了する<code>Application.Quit</code>、それでもプロセスが残ってしまう場合の対処については、別記事でCloseまわりだけを掘り下げています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-close-workbook-quit-excel/">【VBA】ブックを閉じる・Excelを終了する完全ガイド【保存有無の制御＋プロセスが残る問題の対処】</a>
						<span class="p-blogCard__excerpt">VBAでブックを閉じるだけなら、Closeと書けば一応動きます。 VBSub CloseBook_Quick() ActiveWorkbook.Close End SubSub CloseBook_Quick() ActiveWorkbook.Close End S&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">よくあるエラーと対処</h2>



<h3 class="wp-block-heading">「別のプロセスで使用されているため、アクセスできません」</h3>



<p class="wp-block-paragraph">同名ブックがすでに開かれているか、他のユーザーが同じファイルを開いている状態です。「存在確認と多重オープンチェックをセットで行う」で紹介したチェックを入れておくと、少なくとも自分のマクロ内での多重オープンは防げます。</p>



<h3 class="wp-block-heading">保護されたシートで実行時エラー1004が出る</h3>



<p class="wp-block-paragraph">保護中のシートにVBAから書き込もうとしたときに起きます。一時的にUnprotectしてから処理する方法もありますが、頻繁に書き込むなら<code>UserInterfaceOnly:=True</code>での保護に切り替えたほうが処理がシンプルになります。</p>



<h3 class="wp-block-heading">シートが見つからないという実行時エラー9</h3>



<p class="wp-block-paragraph">シート名の全角/半角の違いや、末尾の空白によるタイプミスが原因のことがほとんどです。「シートの存在確認」で紹介した関数を先頭に挟んでおくと、エラーメッセージだけで済んで原因調査がしやすくなります。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">ブック・シート操作は「開く」「操作する」「保護する」「閉じる」の4フェーズで考えると迷いません。特に保護は、UserInterfaceOnly:=Trueを知っているかどうかで実装の手間がかなり変わります。</p>



<p class="wp-block-paragraph">そして最後の「閉じる」を忘れないこと。開いたら閉じる、それだけのことですが、タスクマネージャーにExcel.exeが積み上がっていくのを見て初めて気づく人は、僕以外にもきっといるはずです。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【VBA】ファイル・CSV操作完全ガイド｜出力・文字コード・フォルダ操作をまとめて解説</title>
		<link>https://cfxlog.com/vba-file-csv-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 03 Aug 2026 07:01:59 +0000</pubDate>
				<category><![CDATA[VBA]]></category>
		<category><![CDATA[Excel自動化]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5448</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/vba-file-csv-guide-1024x538.png" class="webfeedsFeaturedVisual" /></p>VBAでテストを回していた頃、結果を手作業でコピーして残すのが面倒で、必ずCSVに書き出してバックアップするようにしていた。 手作業だとうっかり上書きしてしまうこともある。だから「実行したら結果が自動でCSVになり、日付 [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/vba-file-csv-guide-1024x538.png" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">VBAでテストを回していた頃、結果を手作業でコピーして残すのが面倒で、必ずCSVに書き出してバックアップするようにしていた。</p>



<p class="wp-block-paragraph">手作業だとうっかり上書きしてしまうこともある。だから「実行したら結果が自動でCSVになり、日付付きのフォルダに残る」という状態を作っておくと安心できる。</p>



<p class="wp-block-paragraph">この記事では、シートのCSV出力から文字コードの注意点、フォルダ操作、それらを組み合わせたバックアップマクロまで、実務でそのまま使える形でまとめました。</p>



<p class="wp-block-paragraph">CSVではなく印刷用の帳票を保存したい場合は、<a href="https://cfxlog.com/vba-pdf-export-guide/">VBAでPDF出力する方法</a>を参照してください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-guide/">Excel VBA完全入門ガイド｜マクロの基礎から実践まで全ステップ解説</a>
						<span class="p-blogCard__excerpt">VBAって何？マクロとどう違うの？ VBAを始めたいけど、何から手をつければいいかわからない Excelの繰り返し作業を自動化して、残業を減らしたい このような疑問にお答&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">シート全体をCSV出力する（基本）</h2>



<p class="wp-block-paragraph">まずは最もシンプルな方法として、アクティブシート全体をCSV出力するコードです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Public Sub ExportSheetToCSV()
    Dim ws As Worksheet
    Dim outputPath As String
    Dim fileNum As Integer
    Dim i As Long, j As Long
    Dim lastRow As Long, lastCol As Long
    Dim outputLine As String
    Dim cellValue As String

    Set ws = ThisWorkbook.ActiveSheet

    ' 最終行・最終列を取得
    lastRow = ws.Cells(ws.Rows.Count, 1).End(xlUp).Row
    lastCol = ws.Cells(1, ws.Columns.Count).End(xlToLeft).Column

    ' 出力先パスを設定（Excelファイルと同じフォルダ）
    outputPath = ThisWorkbook.Path &amp; "\output.csv"

    fileNum = FreeFile
    Open outputPath For Output As #fileNum

    For i = 1 To lastRow
        outputLine = ""
        For j = 1 To lastCol
            cellValue = CStr(ws.Cells(i, j).Value)

            ' カンマ・ダブルクォートを含む場合はダブルクォートで囲む
            If InStr(cellValue, ",") > 0 Or InStr(cellValue, """") > 0 Then
                cellValue = """" &amp; Replace(cellValue, """", """""") &amp; """"
            End If

            outputLine = outputLine &amp; cellValue
            If j &lt; lastCol Then outputLine = outputLine &amp; ","
        Next j
        Print #fileNum, outputLine
    Next i

    Close #fileNum
    MsgBox "CSV出力が完了しました。", vbInformation
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">ExportSheetToCSV</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> ws </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Worksheet</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> fileNum </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Integer</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> i </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> j</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> lastRow </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> lastCol</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputLine </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> cellValue </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">ws</span><span style="color: #D4D4D4"> = ThisWorkbook.ActiveSheet</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos; 最終行・最終列を取得</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">lastRow</span><span style="color: #D4D4D4"> = ws.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(ws.Rows.Count, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">).</span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">xlUp</span><span style="color: #D4D4D4">).Row</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">lastCol</span><span style="color: #D4D4D4"> = ws.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, ws.Columns.</span><span style="color: #9CDCFE">Count</span><span style="color: #D4D4D4">).</span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">xlToLeft</span><span style="color: #D4D4D4">).Column</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos; 出力先パスを設定（Excelファイルと同じフォルダ）</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;\output.csv&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">fileNum</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> FreeFile</span></span>
<span class="line"><span style="color: #D4D4D4">    Open outputPath </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> Output As #fileNum</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> lastRow</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">outputLine</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">j</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> lastCol</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CStr</span><span style="color: #D4D4D4">(ws.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> j</span><span style="color: #D4D4D4">).</span><span style="color: #9CDCFE">Value</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #6A9955">&apos; カンマ・ダブルクォートを含む場合はダブルクォートで囲む</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;,&quot;</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> Or </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">                </span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">Replace</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">) &amp; </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">End If</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #9CDCFE">outputLine</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> outputLine</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> cellValue</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">j</span><span style="color: #D4D4D4"> &lt;</span><span style="color: #9CDCFE"> lastCol</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">outputLine</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> outputLine</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;,&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> j</span></span>
<span class="line"><span style="color: #D4D4D4">        Print #fileNum,</span><span style="color: #9CDCFE"> outputLine</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> i</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    Close #fileNum</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;CSV出力が完了しました。&quot;</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbInformation</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>ActiveSheet</code>を対象にしているので、どのシートでも使いまわせる</li>



<li><code>End(xlUp)</code> / <code>End(xlToLeft)</code>でデータのある最終行・最終列を自動取得</li>



<li>カンマやダブルクォートを含むセルは自動でダブルクォートで囲む（CSV形式のルール）</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ただし、この書き方はセルを1つずつ読み書きしているので、データが数千行を超えたあたりから明らかに遅くなる。</p>



<h2 class="wp-block-heading">範囲指定でCSV出力する（配列で高速化）</h2>



<p class="wp-block-paragraph">大量データを扱うなら、セルを1つずつ読み書きするのではなく、範囲を配列にまとめて取得してから書き出すほうが圧倒的に速い。</p>



<p class="wp-block-paragraph">以下は、<code>UsedRange</code>（シートの使用中セル範囲）を配列で取得し、CSV用のエスケープ処理を関数に分けて整理したコードです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(3 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

'===============================
' メイン処理
'===============================
Public Sub ExportUsedRangeToCSV()
    On Error GoTo ErrorHandler

    Dim dataArray As Variant
    Dim outputPath As String
    Dim fileNum As Integer
    Dim i As Long

    '--- 対象データを取得 ---
    dataArray = GetSheetData("Sheet1")

    '--- 出力ファイルパス ---
    outputPath = ThisWorkbook.Path &amp; "\output.csv"

    '--- ファイルを開く ---
    fileNum = FreeFile
    Open outputPath For Output As #fileNum

    '--- CSV形式で書き込み ---
    For i = LBound(dataArray, 1) To UBound(dataArray, 1)
        Print #fileNum, ArrayRowToCSVLine(dataArray, i)
    Next i

    '--- ファイルを閉じる ---
    Close #fileNum

    MsgBox "CSVファイルを出力しました。", vbInformation
    Exit Sub

'--- エラー処理 ---
ErrorHandler:
    MsgBox GetErrorMessage(Err.Number, Err.Description), vbCritical
    On Error Resume Next
    Close #fileNum
End Sub


'===============================
' シートから使用中範囲を配列取得
'===============================
Private Function GetSheetData(sheetName As String) As Variant
    Dim ws As Worksheet
    Set ws = ThisWorkbook.Worksheets(sheetName)
    GetSheetData = ws.UsedRange.Value
End Function


'===============================
' 1セル分のCSV用エスケープ処理
'===============================
Private Function EscapeCSVValue(value As Variant) As String
    Dim cellValue As String
    cellValue = CStr(value)

    ' 囲むべき条件：カンマ、ダブルクォート、改行を含む場合
    If InStr(cellValue, ",") > 0 _
       Or InStr(cellValue, """") > 0 _
       Or InStr(cellValue, vbCr) > 0 _
       Or InStr(cellValue, vbLf) > 0 Then

        cellValue = """" &amp; Replace(cellValue, """", """""") &amp; """"
    End If

    EscapeCSVValue = cellValue
End Function


'===============================
' 配列の1行をCSV文字列に変換
'===============================
Private Function ArrayRowToCSVLine(dataArray As Variant, rowIndex As Long) As String
    Dim j As Long, line As String
    For j = LBound(dataArray, 2) To UBound(dataArray, 2)
        line = line &amp; EscapeCSVValue(dataArray(rowIndex, j))
        If j &lt; UBound(dataArray, 2) Then line = line &amp; ","
    Next j
    ArrayRowToCSVLine = line
End Function


'===============================
' エラーメッセージ生成
'===============================
Private Function GetErrorMessage(errNum As Long, errDesc As String) As String
    Select Case errNum
        Case 70: GetErrorMessage = "アクセス権限がありません。ファイルが開かれていないか確認してください。"
        Case 75: GetErrorMessage = "ファイルパスが無効です。"
        Case 76: GetErrorMessage = "指定されたパスが見つかりません。"
        Case 6:  GetErrorMessage = "ファイルサイズが大きすぎます。"
        Case Else
            GetErrorMessage = "予期せぬエラーが発生しました。" &amp; vbCrLf &amp; _
                               "番号: " &amp; errNum &amp; vbCrLf &amp; _
                               "説明: " &amp; errDesc
    End Select
End Function</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #6A9955">&apos; メイン処理</span></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">ExportUsedRangeToCSV</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">On Error GoTo </span><span style="color: #D4D4D4">ErrorHandler</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> dataArray </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Variant</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> fileNum </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Integer</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> i </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- 対象データを取得 ---</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">GetSheetData</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Sheet1&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- 出力ファイルパス ---</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;\output.csv&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- ファイルを開く ---</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">fileNum</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> FreeFile</span></span>
<span class="line"><span style="color: #D4D4D4">    Open outputPath </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> Output As #fileNum</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- CSV形式で書き込み ---</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">LBound</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">UBound</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        Print #fileNum, </span><span style="color: #DCDCAA">ArrayRowToCSVLine</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> i</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> i</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- ファイルを閉じる ---</span></span>
<span class="line"><span style="color: #D4D4D4">    Close #fileNum</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;CSVファイルを出力しました。&quot;</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbInformation</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">&apos;--- エラー処理 ---</span></span>
<span class="line"><span style="color: #D4D4D4">ErrorHandler:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">GetErrorMessage</span><span style="color: #D4D4D4">(Err.Number, Err.</span><span style="color: #9CDCFE">Description</span><span style="color: #D4D4D4">),</span><span style="color: #9CDCFE"> vbCritical</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">On Error Resume Next</span></span>
<span class="line"><span style="color: #D4D4D4">    Close #fileNum</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #6A9955">&apos; シートから使用中範囲を配列取得</span></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #569CD6">Private Function </span><span style="color: #DCDCAA">GetSheetData</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">sheetName</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">String</span><span style="color: #D4D4D4">) As </span><span style="color: #4EC9B0">Variant</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> ws </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Worksheet</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">ws</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #DCDCAA">Worksheets</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">sheetName</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">GetSheetData</span><span style="color: #D4D4D4"> = ws.UsedRange.Value</span></span>
<span class="line"><span style="color: #569CD6">End Function</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #6A9955">&apos; 1セル分のCSV用エスケープ処理</span></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #569CD6">Private Function </span><span style="color: #DCDCAA">EscapeCSVValue</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">value</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Variant</span><span style="color: #D4D4D4">) As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> cellValue </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">value</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos; 囲むべき条件：カンマ、ダブルクォート、改行を含む場合</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;,&quot;</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> _</span></span>
<span class="line"><span style="color: #D4D4D4">       Or </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> _</span></span>
<span class="line"><span style="color: #D4D4D4">       Or </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbCr</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> _</span></span>
<span class="line"><span style="color: #D4D4D4">       Or </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbLf</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">Replace</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">) &amp; </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End If</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">EscapeCSVValue</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> cellValue</span></span>
<span class="line"><span style="color: #569CD6">End Function</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #6A9955">&apos; 配列の1行をCSV文字列に変換</span></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #569CD6">Private Function </span><span style="color: #DCDCAA">ArrayRowToCSVLine</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Variant</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> rowIndex</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Long</span><span style="color: #D4D4D4">) As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> j </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> line</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">j</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">LBound</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">UBound</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">line</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> line</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">EscapeCSVValue</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">dataArray</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">rowIndex</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> j</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">j</span><span style="color: #D4D4D4"> &lt; </span><span style="color: #DCDCAA">UBound</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">line</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> line</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;,&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> j</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">ArrayRowToCSVLine</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> line</span></span>
<span class="line"><span style="color: #569CD6">End Function</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #6A9955">&apos; エラーメッセージ生成</span></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #569CD6">Private Function </span><span style="color: #DCDCAA">GetErrorMessage</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">errNum</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Long</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> errDesc</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">String</span><span style="color: #D4D4D4">) As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Select</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Case</span><span style="color: #D4D4D4"> errNum</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Case</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">70</span><span style="color: #D4D4D4">: </span><span style="color: #9CDCFE">GetErrorMessage</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;アクセス権限がありません。ファイルが開かれていないか確認してください。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Case</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">75</span><span style="color: #D4D4D4">: </span><span style="color: #9CDCFE">GetErrorMessage</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;ファイルパスが無効です。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Case</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">76</span><span style="color: #D4D4D4">: </span><span style="color: #9CDCFE">GetErrorMessage</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;指定されたパスが見つかりません。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Case</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">6</span><span style="color: #D4D4D4">:  </span><span style="color: #9CDCFE">GetErrorMessage</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;ファイルサイズが大きすぎます。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Case</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Else</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #9CDCFE">GetErrorMessage</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;予期せぬエラーが発生しました。&quot;</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> vbCrLf</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">                               </span><span style="color: #CE9178">&quot;番号: &quot;</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> errNum</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> vbCrLf</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> _</span></span>
<span class="line"><span style="color: #D4D4D4">                               </span><span style="color: #CE9178">&quot;説明: &quot;</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> errDesc</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End Select</span></span>
<span class="line"><span style="color: #569CD6">End Function</span></span></code></pre></div>



<p class="wp-block-paragraph">関数を分けているのは、あとで「日付フォルダにバックアップする」マクロに組み込むときに、<code>GetSheetData</code>や<code>ArrayRowToCSVLine</code>をそのまま呼び出せるようにするためです。</p>



<h2 class="wp-block-heading">文字コード（Shift-JIS / UTF-8）に気をつける</h2>



<p class="wp-block-paragraph">ここは実務でいちばん引っかかりやすいポイントです。VBAの標準的なファイル出力（<code>Open ... For Output</code>）は、Windowsのデフォルト文字コードである<strong>Shift-JIS</strong>でCSVを作成します。</p>



<p class="wp-block-paragraph">Excelで開くだけなら問題ありませんが、僕は以前、このCSVをそのままPython側の別システムに渡したところ、文字化けして読み込めなかったことがあります。<strong>他システムに連携する場合はUTF-8が求められることが多い</strong>ので、出力先に応じて使い分ける必要があります。</p>



<h3 class="wp-block-heading">Shift-JISで出力する（デフォルト）</h3>



<p class="wp-block-paragraph"><code>Open outputPath For Output As #fileNum</code>の標準コードがそのままShift-JIS出力になります。追加の設定は不要です。</p>



<h3 class="wp-block-heading">UTF-8で出力する（ADODB.Streamを使う）</h3>



<p class="wp-block-paragraph">UTF-8で出力したい場合は<code>ADODB.Stream</code>を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Public Sub ExportToCSV_UTF8()
    Dim ws As Worksheet
    Dim stream As Object
    Dim i As Long, j As Long
    Dim lastRow As Long, lastCol As Long
    Dim outputLine As String
    Dim cellValue As String
    Dim outputPath As String

    Set ws = ThisWorkbook.ActiveSheet
    lastRow = ws.Cells(ws.Rows.Count, 1).End(xlUp).Row
    lastCol = ws.Cells(1, ws.Columns.Count).End(xlToLeft).Column
    outputPath = ThisWorkbook.Path &amp; "\output_utf8.csv"

    ' ADODB.Streamを使ってUTF-8で書き込む
    Set stream = CreateObject("ADODB.Stream")
    stream.Type = 2           ' テキストモード
    stream.Charset = "UTF-8"
    stream.Open

    For i = 1 To lastRow
        outputLine = ""
        For j = 1 To lastCol
            cellValue = CStr(ws.Cells(i, j).Value)
            If InStr(cellValue, ",") > 0 Or InStr(cellValue, """") > 0 Then
                cellValue = """" &amp; Replace(cellValue, """", """""") &amp; """"
            End If
            outputLine = outputLine &amp; cellValue
            If j &lt; lastCol Then outputLine = outputLine &amp; ","
        Next j
        stream.WriteText outputLine &amp; vbCrLf
    Next i

    stream.SaveToFile outputPath, 2  ' 2 = 上書き保存
    stream.Close

    MsgBox "UTF-8でCSV出力しました。", vbInformation
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">ExportToCSV_UTF8</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> ws </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Worksheet</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> stream </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Object</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> i </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> j</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> lastRow </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> lastCol</span><span style="color: #D4D4D4"> As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputLine </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> cellValue </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">ws</span><span style="color: #D4D4D4"> = ThisWorkbook.ActiveSheet</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">lastRow</span><span style="color: #D4D4D4"> = ws.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(ws.Rows.Count, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">).</span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">xlUp</span><span style="color: #D4D4D4">).Row</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">lastCol</span><span style="color: #D4D4D4"> = ws.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, ws.Columns.</span><span style="color: #9CDCFE">Count</span><span style="color: #D4D4D4">).</span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">xlToLeft</span><span style="color: #D4D4D4">).Column</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;\output_utf8.csv&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos; ADODB.Streamを使ってUTF-8で書き込む</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">stream</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CreateObject</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;ADODB.Stream&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    stream.</span><span style="color: #9CDCFE">Type</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">           </span><span style="color: #6A9955">&apos; テキストモード</span></span>
<span class="line"><span style="color: #D4D4D4">    stream.Charset = </span><span style="color: #CE9178">&quot;UTF-8&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    stream.Open</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> lastRow</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">outputLine</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">j</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> lastCol</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CStr</span><span style="color: #D4D4D4">(ws.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> j</span><span style="color: #D4D4D4">).</span><span style="color: #9CDCFE">Value</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;,&quot;</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> Or </span><span style="color: #DCDCAA">InStr</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">                </span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">Replace</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">cellValue</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">) &amp; </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #9CDCFE">outputLine</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> outputLine</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> cellValue</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">j</span><span style="color: #D4D4D4"> &lt;</span><span style="color: #9CDCFE"> lastCol</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">outputLine</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> outputLine</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;,&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> j</span></span>
<span class="line"><span style="color: #D4D4D4">        stream.WriteText </span><span style="color: #9CDCFE">outputLine</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> vbCrLf</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> i</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    stream.SaveToFile outputPath, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955">&apos; 2 = 上書き保存</span></span>
<span class="line"><span style="color: #D4D4D4">    stream.Close</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;UTF-8でCSV出力しました。&quot;</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbInformation</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>stream.Charset = "UTF-8"</code>で文字コードを指定</li>



<li>BOM（バイト順マーク）なしのUTF-8で出力される</li>



<li>Excelで直接開くと文字化けする場合があるが、テキストエディタやPythonでは正常に読める</li>
</ul>
</div></div>



<h2 class="wp-block-heading">フォルダを作成・選択する</h2>



<h3 class="wp-block-heading">フォルダを作成する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub CreateFolder()
    Dim folderPath As String
    folderPath = "C:\Users\YourName\Desktop\TestFolder"

    If Dir(folderPath, vbDirectory) = "" Then
        MkDir folderPath
        MsgBox "フォルダを作成しました！"
    Else
        MsgBox "すでにフォルダがあります！"
    End If
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Sub</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">CreateFolder</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> folderPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">folderPath</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;C:\Users\YourName\Desktop\TestFolder&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">folderPath</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbDirectory</span><span style="color: #D4D4D4">) = </span><span style="color: #CE9178">&quot;&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">        MkDir folderPath</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;フォルダを作成しました！&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Else</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;すでにフォルダがあります！&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">フォルダがなければ作成、あればメッセージを表示するだけのシンプルな作りです。</p>



<h3 class="wp-block-heading">フォルダ選択ダイアログを出す</h3>



<p class="wp-block-paragraph">保存先を毎回固定パスにしたくない場合は、ユーザーにフォルダを選ばせるダイアログを出します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Function SelectFolder() As String
    Dim folderDialog As FileDialog
    Set folderDialog = Application.FileDialog(msoFileDialogFolderPicker)

    If folderDialog.Show = -1 Then
        SelectFolder = folderDialog.SelectedItems(1)
    Else
        SelectFolder = ""
    End If
End Function</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Function</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">SelectFolder</span><span style="color: #D4D4D4">() As String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> folderDialog </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">FileDialog</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">folderDialog</span><span style="color: #D4D4D4"> = </span><span style="color: #4EC9B0">Application</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">FileDialog</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">msoFileDialogFolderPicker</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> folderDialog.</span><span style="color: #9CDCFE">Show</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">-1</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">SelectFolder</span><span style="color: #D4D4D4"> = folderDialog.</span><span style="color: #DCDCAA">SelectedItems</span><span style="color: #D4D4D4">(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Else</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">SelectFolder</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #569CD6">End Function</span></span></code></pre></div>



<p class="wp-block-paragraph">キャンセルされた場合は空文字を返すようにしているので、呼び出し側で必ず判定してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub TestSelectFolder()
    Dim path As String
    path = SelectFolder()
    If path = "" Then Exit Sub
    MsgBox "選択されたフォルダは：" &amp; path
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Sub</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">TestSelectFolder</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> path </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">path</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">SelectFolder</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">path</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;選択されたフォルダは：&quot;</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> path</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<h2 class="wp-block-heading">フォルダ内のファイル名を一括取得する</h2>



<p class="wp-block-paragraph">フォルダの中に何が入っているか一覧化したいときは<code>Dir</code>関数をループで使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub GetFileNamesInFolder()
    Dim folderPath As String
    Dim fileName As String
    Dim i As Long

    folderPath = SelectFolder() &amp; "\"
    If folderPath = "\" Then Exit Sub

    fileName = Dir(folderPath &amp; "*.*")
    i = 1

    Do While fileName &lt;> ""
        Cells(i, 1).Value = fileName
        fileName = Dir
        i = i + 1
    Loop
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Sub</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">GetFileNamesInFolder</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> folderPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> fileName </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> i </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">folderPath</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">SelectFolder</span><span style="color: #D4D4D4">() &amp; </span><span style="color: #CE9178">&quot;\&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">folderPath</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;\&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">fileName</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">folderPath</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;*.*&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">1</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Do</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">While</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">fileName</span><span style="color: #D4D4D4"> &lt;&gt; </span><span style="color: #CE9178">&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">).</span><span style="color: #9CDCFE">Value</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> fileName</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">fileName</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> Dir</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> i</span><span style="color: #D4D4D4"> + </span><span style="color: #B5CEA8">1</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Loop</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">選択したフォルダ内のすべてのファイル名を、ExcelのA列にズラッと表示します。</p>



<h2 class="wp-block-heading">実務での使い分けを体感する：テスト結果を日付フォルダにバックアップする</h2>



<p class="wp-block-paragraph">ここまでのCSV出力とフォルダ操作を組み合わせると、「テストを実行したら、結果が自動でCSVになり、日付付きのフォルダに残る」というマクロが作れます。</p>



<p class="wp-block-paragraph">僕がテスト結果をエビデンスとして残すときによく使っている形です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

'===============================
' テスト結果を日付フォルダにバックアップして開く
'===============================
Public Sub BackupResultsToDateFolder()
    On Error GoTo ErrorHandler

    Dim basePath As String
    Dim newFolder As String
    Dim dataArray As Variant
    Dim outputPath As String
    Dim fileNum As Integer
    Dim i As Long

    '--- バックアップ先の親フォルダを選択 ---
    basePath = SelectFolder()
    If basePath = "" Then Exit Sub

    '--- 日付フォルダを作成 ---
    newFolder = basePath &amp; "\" &amp; Format(Now, "yyyymmdd_hhnnss")
    If Dir(newFolder, vbDirectory) = "" Then
        MkDir newFolder
    End If

    '--- テスト結果（Sheet1のUsedRange）をCSVに書き出す ---
    dataArray = GetSheetData("Sheet1")
    outputPath = newFolder &amp; "\result.csv"

    fileNum = FreeFile
    Open outputPath For Output As #fileNum
    For i = LBound(dataArray, 1) To UBound(dataArray, 1)
        Print #fileNum, ArrayRowToCSVLine(dataArray, i)
    Next i
    Close #fileNum

    '--- 保存したフォルダをそのまま開く ---
    Shell "explorer.exe """ &amp; newFolder &amp; """", vbNormalFocus
    Exit Sub

ErrorHandler:
    MsgBox GetErrorMessage(Err.Number, Err.Description), vbCritical
    On Error Resume Next
    Close #fileNum
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #6A9955">&apos; テスト結果を日付フォルダにバックアップして開く</span></span>
<span class="line"><span style="color: #6A9955">&apos;===============================</span></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">BackupResultsToDateFolder</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">On Error GoTo </span><span style="color: #D4D4D4">ErrorHandler</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> basePath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> newFolder </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> dataArray </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Variant</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outputPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> fileNum </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Integer</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> i </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- バックアップ先の親フォルダを選択 ---</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">basePath</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">SelectFolder</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">basePath</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- 日付フォルダを作成 ---</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">newFolder</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> basePath</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;\&quot;</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">Format</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Now</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;yyyymmdd_hhnnss&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">newFolder</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbDirectory</span><span style="color: #D4D4D4">) = </span><span style="color: #CE9178">&quot;&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">        MkDir newFolder</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End If</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- テスト結果（Sheet1のUsedRange）をCSVに書き出す ---</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">GetSheetData</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Sheet1&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">outputPath</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> newFolder</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;\result.csv&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">fileNum</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> FreeFile</span></span>
<span class="line"><span style="color: #D4D4D4">    Open outputPath </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> Output As #fileNum</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">i</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">LBound</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">UBound</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        Print #fileNum, </span><span style="color: #DCDCAA">ArrayRowToCSVLine</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">dataArray</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> i</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> i</span></span>
<span class="line"><span style="color: #D4D4D4">    Close #fileNum</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">&apos;--- 保存したフォルダをそのまま開く ---</span></span>
<span class="line"><span style="color: #D4D4D4">    Shell </span><span style="color: #CE9178">&quot;explorer.exe &quot;&quot;&quot;</span><span style="color: #D4D4D4"> &amp;</span><span style="color: #9CDCFE"> newFolder</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbNormalFocus</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">ErrorHandler:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">GetErrorMessage</span><span style="color: #D4D4D4">(Err.Number, Err.</span><span style="color: #9CDCFE">Description</span><span style="color: #D4D4D4">),</span><span style="color: #9CDCFE"> vbCritical</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">On Error Resume Next</span></span>
<span class="line"><span style="color: #D4D4D4">    Close #fileNum</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>GetSheetData</code>・<code>ArrayRowToCSVLine</code>・<code>GetErrorMessage</code>は「範囲指定でCSV出力する」の章で紹介した関数をそのまま使っています。CSV出力・フォルダ作成・フォルダを開く、という3つの操作を1つのマクロにまとめただけで、バックアップ作業がボタン1つで終わるようになります。</p>



<h2 class="wp-block-heading">よくあるエラーと対処</h2>



<p class="wp-block-paragraph">ファイル・フォルダ操作は、コードが正しくても環境側の要因でエラーになることがあります。よく出るエラー番号と原因をまとめました。</p>



<figure class="wp-block-table"><table><thead><tr><th>エラー番号</th><th>原因</th><th>対処</th></tr></thead><tbody><tr><td>70</td><td>アクセス権限がない</td><td>ファイルが他のプログラムで開かれていないか確認する</td></tr><tr><td>75</td><td>ファイルパスが無効</td><td>パスの長さ・使用できない文字を確認する</td></tr><tr><td>76</td><td>指定したパスが見つからない</td><td>保存先フォルダが存在するか確認する（先に<code>MkDir</code>する）</td></tr><tr><td>6</td><td>ファイルサイズが大きすぎる</td><td>データ量を減らすか、分割して保存する</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">意外と見落としがちですが、<code>Shell "explorer.exe"</code>でパスを渡すときは、パスをダブルクォートで囲む（<code>""" &amp; path &amp; """"</code>）のを忘れるとフォルダ名にスペースが含まれた瞬間に動かなくなります。</p>



<h2 class="wp-block-heading">よくある質問</h2>



<p class="wp-block-paragraph">本文で触れきれなかった細かい疑問をQ&amp;Aでまとめておきます。</p>



<div class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-main">
<div class="swell-block-faq__item"><h3 class="faq_q">UTF-8で出力したCSVをExcelで開くと文字化けするのはなぜですか？</h3><div class="faq_a">
<p class="wp-block-paragraph"><code>ADODB.Stream</code>で出力したUTF-8はBOM（バイト順マーク）なしのため、Excelが文字コードを正しく判定できず文字化けすることがあります。Excelで直接開いて確認したい場合はShift-JIS出力を、他システムへの連携が目的ならUTF-8のまま渡して問題ありません。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">セルを1つずつ書き込む方法と配列を使う方法、どのくらい速度が変わりますか？</h3><div class="faq_a">
<p class="wp-block-paragraph">数百行程度なら体感差はほぼありません。数千行を超えるあたりから、セル単位のアクセスを繰り返す書き方は明らかに遅くなります。データ件数が読めない場合は、最初から配列で読み込む書き方にしておくのが安全です。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">フォルダ選択ダイアログでキャンセルするとどうなりますか？</h3><div class="faq_a">
<p class="wp-block-paragraph"><code>SelectFolder</code>関数は空文字を返します。呼び出し側で<code>If basePath = "" Then Exit Sub</code>のように判定していないと、空のパスに対してファイル操作を試みてエラー76（パスが見つからない）になります。</p>
</div></div>
</div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">CSV出力は「シート全体か範囲か」「Shift-JISかUTF-8か」で書き方が変わり、フォルダ操作は作成・選択・一覧取得・オープンの4つを組み合わせれば大抵の場面はカバーできます。</p>



<p class="wp-block-paragraph">1つずつ覚えるよりも、この記事の最後のバックアップマクロのように組み合わせてしまったほうが、結局は実務で使い続けやすいです。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【VBA】ブックを閉じる・Excelを終了する完全ガイド【保存有無の制御＋プロセスが残る問題の対処】</title>
		<link>https://cfxlog.com/vba-close-workbook-quit-excel/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 29 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[VBA]]></category>
		<category><![CDATA[Excel自動化]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/vba-close-workbook-quit-excel/</guid>

					<description><![CDATA[VBAでブックを閉じるだけなら、Closeと書けば一応動きます。 ところが実務でぶつかるのは、「閉じたはずなのに、なぜかExcelのプロセスが残っている」「保存確認のダイアログが出て自動化が止まる」という方の悩みだったり [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">VBAでブックを閉じるだけなら、<code>Close</code>と書けば一応動きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub CloseBook_Quick()
    ActiveWorkbook.Close
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> CloseBook_Quick</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#D4D4D4">    ActiveWorkbook.Close</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">ところが実務でぶつかるのは、<strong>「閉じたはずなのに、なぜかExcelのプロセスが残っている」「保存確認のダイアログが出て自動化が止まる」</strong>という方の悩みだったりします。</p>



<p class="wp-block-paragraph">この記事では、ブックを閉じる基本から、Excelアプリケーション自体を終了する方法、そして地味に厄介な「プロセスが残る」問題への対処までをまとめて解説します。</p>



<h2 class="wp-block-heading">VBAでブックを閉じる基本（Workbooks.Close）</h2>



<h3 class="wp-block-heading">最短コードで閉じる</h3>



<p class="wp-block-paragraph">開いたブックを、そのまま閉じるだけならこれで十分です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub CloseBook_Min()
    Dim wb As Workbook
    Set wb = Workbooks.Open("C:\Book1.xlsx")

    ' 何らかの処理

    wb.Close
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> CloseBook_Min</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> = Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C:\Book1.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 何らかの処理</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    wb.Close</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">ただし、これだと変更内容によっては保存確認のダイアログが出ます。<br>自動化の途中でこれが出ると、そこで処理が止まってしまうので困りものです。</p>



<h3 class="wp-block-heading">保存するかどうかを明示する（SaveChanges）</h3>



<p class="wp-block-paragraph">ダイアログを出したくない場合は、<code>SaveChanges</code>引数で保存するかどうかを明示します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub CloseBook_NoSave()
    Dim wb As Workbook
    Set wb = Workbooks.Open("C:\Book1.xlsx")

    ' 何らかの処理（保存不要なケース）

    wb.Close SaveChanges:=False
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> CloseBook_NoSave</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> = Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C:\Book1.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 何らかの処理（保存不要なケース）</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    wb.Close SaveChanges:=</span><span style="color:#569CD6">False</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">保存してから閉じたい場合は<code>True</code>にするだけです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>wb.Close SaveChanges:=True</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">wb.Close SaveChanges:=</span><span style="color:#569CD6">True</span></span></code></pre></div>



<p class="wp-block-paragraph">迷ったらこれを書くだけで、少なくとも「ダイアログで処理が止まる」問題は解決します。</p>



<h3 class="wp-block-heading">確認ダイアログそのものを止める（DisplayAlerts）</h3>



<p class="wp-block-paragraph"><code>SaveChanges</code>とは別に、警告ダイアログ全般を一時的に止めたい場面もあります。<br>そんなときは<code>Application.DisplayAlerts</code>を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub CloseBook_Silent()
    Dim wb As Workbook
    Set wb = Workbooks.Open("C:\Book1.xlsx")

    ' 何らかの処理

    Application.DisplayAlerts = False
    wb.Close SaveChanges:=True
    Application.DisplayAlerts = True
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> CloseBook_Silent</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> = Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C:\Book1.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 何らかの処理</span></span>
<span class="line"></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">DisplayAlerts</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> False</span></span>
<span class="line"><span style="color:#D4D4D4">    wb.Close SaveChanges:=</span><span style="color:#569CD6">True</span></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">DisplayAlerts</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> True</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">Falseにしたら、処理の最後で必ずTrueに戻しておきましょう。戻し忘れると、後続のマクロや手動操作でも警告が出なくなり、保存ミスに気づけなくなります。</p>



<h2 class="wp-block-heading">複数ブックをまとめて閉じる</h2>



<p class="wp-block-paragraph">自分自身（<code>ThisWorkbook</code>）以外を全部閉じたい、というケースもよくあります。<br><code>For Each</code>で回せば一発です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub CloseAllExceptThis()
    Dim wb As Workbook

    For Each wb In Workbooks
        If Not wb Is ThisWorkbook Then
            wb.Close SaveChanges:=False
        End If
    Next wb
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> CloseAllExceptThis</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">    For</span><span style="color:#C586C0"> Each</span><span style="color:#D4D4D4"> wb In Workbooks</span></span>
<span class="line"><span style="color:#C586C0">        If</span><span style="color:#D4D4D4"> Not wb Is ThisWorkbook </span><span style="color:#C586C0">Then</span></span>
<span class="line"><span style="color:#D4D4D4">            wb.Close SaveChanges:=</span><span style="color:#569CD6">False</span></span>
<span class="line"><span style="color:#C586C0">        End If</span></span>
<span class="line"><span style="color:#C586C0">    Next</span><span style="color:#D4D4D4"> wb</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>Workbooks</code>コレクションはループ中に要素が減っていくので、<code>For Each</code>で素直に回して問題ありません。</p>



<h2 class="wp-block-heading">Excelアプリケーション自体を終了する（Application.Quit）</h2>



<p class="wp-block-paragraph">ここまでは「ブックを閉じる」話でした。<br>ですが、<code>Workbooks.Close</code>はあくまでブックを閉じるだけで、Excelアプリケーション自体は起動したままです。</p>



<p class="wp-block-paragraph">Excelごと終了したいときは<code>Application.Quit</code>を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub QuitExcel()
    Application.DisplayAlerts = False
    Application.Quit
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> QuitExcel</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">DisplayAlerts</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> False</span></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.Quit</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>Application.Quit</code>も、保存されていないブックが残っていれば確認ダイアログを出します。<br>ここでも<code>DisplayAlerts</code>の出番、というわけです。</p>



<h2 class="wp-block-heading">【実務で詰まりやすい】閉じたはずなのにプロセスが残る問題</h2>



<p class="wp-block-paragraph">終了処理は意外と見落としがちですが、ここを雑にやると<code>Workbooks.Close</code>や<code>Application.Quit</code>を呼んだつもりでも、タスクマネージャーを開くとExcelのプロセス（EXCEL.EXE）がしぶとく残っていることがあります。</p>



<p class="wp-block-paragraph">原因のほとんどは、<strong>オブジェクトへの参照を変数に持たず、そのまま使い捨てにしている</strong>ことです。</p>



<p class="wp-block-paragraph">たとえばこんな書き方。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>' NGパターン：参照を変数に保持しない
Workbooks.Open("C:\Book1.xlsx").Sheets(1).Range("A1").Value = "テスト"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955">' NGパターン：参照を変数に保持しない</span></span>
<span class="line"><span style="color:#D4D4D4">Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C:\Book1.xlsx"</span><span style="color:#D4D4D4">).</span><span style="color:#DCDCAA">Sheets</span><span style="color:#D4D4D4">(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">).</span><span style="color:#DCDCAA">Range</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"A1"</span><span style="color:#D4D4D4">).</span><span style="color:#9CDCFE">Value</span><span style="color:#D4D4D4"> = </span><span style="color:#CE9178">"テスト"</span></span></code></pre></div>



<p class="wp-block-paragraph">これ自体はエラーなく動きますが、開いたブックへの参照がどこにも残らないまま次々にオブジェクトが生成されるので、後片付けのタイミングを自分でコントロールできません。</p>



<p class="wp-block-paragraph">対策はシンプルで、<strong>Workbook・Worksheetそれぞれを変数に受けてから使い、用が済んだら明示的にNothingを代入する</strong>ことです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Dim wb As Workbook
Dim ws As Worksheet

Set wb = Workbooks.Open("C:\Book1.xlsx")
Set ws = wb.Sheets(1)
ws.Range("A1").Value = "テスト"

wb.Close SaveChanges:=True
Set ws = Nothing
Set wb = Nothing</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"><span style="color:#569CD6">Dim</span><span style="color:#9CDCFE"> ws </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Worksheet</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> = Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C:\Book1.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#569CD6">Set </span><span style="color:#9CDCFE">ws</span><span style="color:#D4D4D4"> = wb.</span><span style="color:#DCDCAA">Sheets</span><span style="color:#D4D4D4">(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">ws.</span><span style="color:#DCDCAA">Range</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"A1"</span><span style="color:#D4D4D4">).</span><span style="color:#9CDCFE">Value</span><span style="color:#D4D4D4"> = </span><span style="color:#CE9178">"テスト"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">wb.Close SaveChanges:=</span><span style="color:#569CD6">True</span></span>
<span class="line"><span style="color:#569CD6">Set </span><span style="color:#9CDCFE">ws</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> Nothing</span></span>
<span class="line"><span style="color:#569CD6">Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> Nothing</span></span></code></pre></div>



<p class="wp-block-paragraph">ちなみにPythonからwin32com経由でExcelを操作するときも、根っこはまったく同じ問題が起きます。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/AdobeStock_504301962-768x446-1-300x174.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-win32com-excel/">【Python × Excel自動化】openpyxlでグラフが消える問題を解決｜win32comで書式を保持して操作する方法</a>
						<span class="p-blogCard__excerpt">Python の Excel 系ライブラリは openpyxl が有名です。 ところが、openpyxl はグラフや罫線などが消えてしまう不具合があり、クライアントワークなどで安全に自動化し&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">言語が変わっても、Excel側から見れば同じCOMオブジェクトなので、後片付けの発想は共通というわけです。</p>



<h2 class="wp-block-heading">実務テンプレ（安全に閉じて終了する完成形）</h2>



<p class="wp-block-paragraph">ここまでの内容を一つにまとめると、こうなります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Sub CloseAndQuit_Template()
    Dim wb As Workbook
    Set wb = Workbooks.Open("C:\Book1.xlsx")

    ' ここに自動化したい処理を書く

    Application.DisplayAlerts = False
    wb.Close SaveChanges:=True
    Application.Quit
    Application.DisplayAlerts = True

    Set wb = Nothing
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> CloseAndQuit_Template</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> wb </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Workbook</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> = Workbooks.</span><span style="color:#DCDCAA">Open</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"C:\Book1.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' ここに自動化したい処理を書く</span></span>
<span class="line"></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">DisplayAlerts</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> False</span></span>
<span class="line"><span style="color:#D4D4D4">    wb.Close SaveChanges:=</span><span style="color:#569CD6">True</span></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.Quit</span></span>
<span class="line"><span style="color:#4EC9B0">    Application</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">DisplayAlerts</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> True</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">wb</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> Nothing</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">保存有無を決めて、ダイアログを黙らせて、参照を手放す。<br>これだけ押さえておけば、バッチ処理で何百回実行してもプロセスが積み上がることはありません。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">冒頭でも触れた通り、ブックを閉じること自体は難しくありません。<br>ただ、保存確認とプロセスの後片付けまで含めて初めて「閉じる処理」が完成する、という点は見落とされがちです。</p>


<div class="swell-block-postLink">投稿が見つかりません。</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-guide/">Excel VBA完全入門ガイド｜マクロの基礎から実践まで全ステップ解説</a>
						<span class="p-blogCard__excerpt">VBAって何？マクロとどう違うの？ VBAを始めたいけど、何から手をつければいいかわからない Excelの繰り返し作業を自動化して、残業を減らしたい このような疑問にお答&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Pythonで電子メール（.emlファイル）を読み込む方法</title>
		<link>https://cfxlog.com/python-read-eml-file/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 12 Mar 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5023</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-read-eml-file.jpg" class="webfeedsFeaturedVisual" /></p>Pythonを使ってメールファイルを読み込みたい！ このような方に向けて、拡張子.emlファイルの読み込み方をご紹介します。 eml ファイルとは、電子メールのメッセージを保存するためのファイル形式です。 ファイルの中に [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-read-eml-file.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="is-style-crease wp-block-paragraph">Pythonを使ってメールファイルを読み込みたい！</p>



<p class="wp-block-paragraph">このような方に向けて、拡張子<code>.eml</code>ファイルの読み込み方をご紹介します。</p>



<p class="wp-block-paragraph">eml ファイルとは、電子メールのメッセージを保存するためのファイル形式です。</p>



<p class="wp-block-paragraph">ファイルの中には以下のような情報が含まれています。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>.emlファイルの内容</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li>送信者情報</li>



<li>受信者情報</li>



<li>件名</li>



<li>本文</li>



<li>添付ファイル</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Python には email という標準ライブラリが用意されていて、これを使えば eml ファイルを読み込むことができます。</p>



<h2 class="wp-block-heading">eml ファイルを読み込む方法</h2>



<p class="wp-block-paragraph">「eml ファイルを読み込む」ということを分解すると、次のようなステップに分けられます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>eml ファイル全体を読み込む</li>



<li>送信者情報、件名などの要素を取得する</li>



<li>本文を取得する</li>
</ol>
</div></div>



<p class="wp-block-paragraph">それぞれ順番に解説していきます。</p>



<h3 class="wp-block-heading">1. eml ファイル全体を読み込む</h3>



<p class="wp-block-paragraph">まずは eml ファイルを、Python で扱えるオブジェクトとして読み込みます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from email import policy
from email.parser import BytesParser

def read_email(eml_file_path):
    """
    emlファイルを読み込む
    """
    with open(eml_file_path, mode="rb") as f:
        msg = BytesParser(policy=policy.default).parse(f)
    return msg</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> email </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> policy</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> email.parser </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BytesParser</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_email</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">eml_file_path</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #CE9178">    emlファイルを読み込む</span></span>
<span class="line"><span style="color: #CE9178">    &quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">with</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">open</span><span style="color: #D4D4D4">(eml_file_path, </span><span style="color: #9CDCFE">mode</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;rb&quot;</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> f:</span></span>
<span class="line"><span style="color: #D4D4D4">        msg = BytesParser(</span><span style="color: #9CDCFE">policy</span><span style="color: #D4D4D4">=policy.default).parse(f)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> msg</span></span></code></pre></div>



<p class="wp-block-paragraph">この read_email() 関数の引数として、拡張子が .eml のファイルパスを渡してあげればパースできます。</p>



<p class="wp-block-paragraph">戻り値の msg は、Message オブジェクトです。</p>



<p class="wp-block-paragraph">アノテーションをつけるなら、以下のような書き方になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from email import policy
from email.message import Message
from email.parser import BytesParser

def read_email(eml_file_path: str) -> Message:
    """
    emlファイルを読み込む
    """
    with open(eml_file_path, mode="rb") as f:
        msg = BytesParser(policy=policy.default).parse(f)
    return msg</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> email </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> policy</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> email.message </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Message</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> email.parser </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BytesParser</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_email</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">eml_file_path</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">str</span><span style="color: #D4D4D4">) -&gt; Message:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #CE9178">    emlファイルを読み込む</span></span>
<span class="line"><span style="color: #CE9178">    &quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">with</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">open</span><span style="color: #D4D4D4">(eml_file_path, </span><span style="color: #9CDCFE">mode</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;rb&quot;</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> f:</span></span>
<span class="line"><span style="color: #D4D4D4">        msg = BytesParser(</span><span style="color: #9CDCFE">policy</span><span style="color: #D4D4D4">=policy.default).parse(f)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> msg</span></span></code></pre></div>



<p class="is-style-icon_pen wp-block-paragraph">パースとは「ただのテキストファイル」を解析して、Python で認識可能なオブジェクトに変換することです。</p>



<h3 class="wp-block-heading">2. 送信者情報、件名などの要素を取得する</h3>



<p class="wp-block-paragraph">1. で取得した Message オブジェクトから、以下の情報を取得していきます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>送信者メールアドレス</li>



<li>受信者メールアドレス</li>



<li>件名</li>



<li>CC</li>



<li>送信日時</li>



<li>メールごとに振られたユニークな識別子</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Message オブジェクトは辞書のような方法でアクセスできます。</p>



<p class="wp-block-paragraph">取得例は以下の通り。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 送信者メールアドレス
from_ = msg.get("From", None)

# 受信者メールアドレス
to = msg.get("To", None)

# 件名
subject = msg.get("Subject", None)

# CC
cc = msg,get("CC", None)

# 送信日時
date = msg.get("Date", None)

# メールごとに振られたユニークな識別子
message_id = msg.get("Message-ID", None)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 送信者メールアドレス</span></span>
<span class="line"><span style="color: #D4D4D4">from_ = msg.get(</span><span style="color: #CE9178">&quot;From&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 受信者メールアドレス</span></span>
<span class="line"><span style="color: #D4D4D4">to = msg.get(</span><span style="color: #CE9178">&quot;To&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 件名</span></span>
<span class="line"><span style="color: #D4D4D4">subject = msg.get(</span><span style="color: #CE9178">&quot;Subject&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># CC</span></span>
<span class="line"><span style="color: #D4D4D4">cc = msg,get(</span><span style="color: #CE9178">&quot;CC&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 送信日時</span></span>
<span class="line"><span style="color: #D4D4D4">date = msg.get(</span><span style="color: #CE9178">&quot;Date&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># メールごとに振られたユニークな識別子</span></span>
<span class="line"><span style="color: #D4D4D4">message_id = msg.get(</span><span style="color: #CE9178">&quot;Message-ID&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">もちろん通常の辞書と同様<code>msg["From"]</code>のような形でも取り出せますが、上記では取得できなかったときのために<code>get()</code>メソッドに<code>None</code>を明示しておくことで、安全にアクセスできるようにしました。</p>



<p class="wp-block-paragraph">なお、メールアドレスはname&lt;sample@name.com&gt;の形式になることがあります。<br>これを「名前部分」と「純粋なメールアドレス部分」を分けて取得したい場合にはparseaddr()メソッドを使って分離しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def divide_name_and_mailaddress(mailaddress):
    """
    フルメールアドレス, 純粋なメールアドレス部分を分ける
    """
    try:
        return [parseaddr(mailaddress)&#91;0&#93;, parseaddr(mailaddress)&#91;1&#93;]
    except Exception:
        return None</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">divide_name_and_mailaddress</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">mailaddress</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #CE9178">    フルメールアドレス, 純粋なメールアドレス部分を分ける</span></span>
<span class="line"><span style="color: #CE9178">    &quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> [parseaddr(mailaddress)&#91;</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">&#93;, parseaddr(mailaddress)&#91;</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">&#93;]</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">except</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Exception</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">None</span></span></code></pre></div>



<p class="is-style-icon_info wp-block-paragraph">BCC は受信者側から見えないので、<code>msg["BCC"]</code>とすることはまずありません。</p>



<h3 class="wp-block-heading">3. 本文を取得する</h3>



<p class="wp-block-paragraph">本文の取得には、一工夫が必要です。</p>



<p class="wp-block-paragraph">大前提として、メールファイルには次の2種類があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>シングルパート</li>



<li>マルチパート</li>
</ul>
</div></div>



<p class="wp-block-paragraph">それぞれ簡単に説明します。</p>



<p class="wp-block-paragraph">まずシングルパートは、ただのテキストだけからなるシンプルな構成のものです。</p>



<p class="wp-block-paragraph">一方のマルチパートは、テキストとHTMLが混在していたり、テキストの他に添付ファイルを含む場合にあたります。</p>



<p class="wp-block-paragraph">つまり色々なコンテンツがある場合にはマルチパート、単一のコンテンツのメールならシングルパートということになります。</p>



<p class="wp-block-paragraph">メール本文を読み込むには、マルチパートかシングルパートかを場合分けして処理する必要があるので、以下のように条件分岐を組んで取り出します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def get_email_body(msg: Message) -> str:
    """
    メール本文を取得する
    """
    if msg.is_multipart():
        # マルチパートメールの場合
        # つまり、添付ありやHTML形式のメールの場合
        for part in msg.walk():
            # コンテントタイプを取得
            content_type = part.get_content_type()
            # Content-Dispositionヘッダの内容を取得する
            content_disposition = str(part.get("Content-Disposition"))

            if content_type == "text/plain" and "attachment" not in content_disposition:
                payload = part.get_payload(decode=True)
                detected = chardet.detect(payload)
                encoding = (
                    detected&#91;"encoding"&#93;
                    if detected&#91;"encoding"&#93; is not None
                    else "utf-8"
                )
                # エラーの場合は文字化けしてでも文字列を出力
                return payload.decode(encoding, errors="replace")
    else:
        # メールの内容を取得
        payload = msg.get_payload(decode=True)
        # エンコード方式を確認
        detected = chardet.detect(payload)
        # 得られたエンコード方式がnoneならutf-8を、そうでなければ得られたものを採用
        encoding = detected&#91;"encoding"&#93; if detected&#91;"encoding"&#93; is not None else "utf-8"
        # エラーの場合は文字化けしてでも文字列を出力
        return payload.decode(encoding, errors="replace")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">get_email_body</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">msg</span><span style="color: #D4D4D4">: Message) -&gt; </span><span style="color: #4EC9B0">str</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #CE9178">    メール本文を取得する</span></span>
<span class="line"><span style="color: #CE9178">    &quot;&quot;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> msg.is_multipart():</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># マルチパートメールの場合</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># つまり、添付ありやHTML形式のメールの場合</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> part </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> msg.walk():</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #6A9955"># コンテントタイプを取得</span></span>
<span class="line"><span style="color: #D4D4D4">            content_type = part.get_content_type()</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #6A9955"># Content-Dispositionヘッダの内容を取得する</span></span>
<span class="line"><span style="color: #D4D4D4">            content_disposition = </span><span style="color: #4EC9B0">str</span><span style="color: #D4D4D4">(part.get(</span><span style="color: #CE9178">&quot;Content-Disposition&quot;</span><span style="color: #D4D4D4">))</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> content_type == </span><span style="color: #CE9178">&quot;text/plain&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">and</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;attachment&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">not</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">in</span><span style="color: #D4D4D4"> content_disposition:</span></span>
<span class="line"><span style="color: #D4D4D4">                payload = part.get_payload(</span><span style="color: #9CDCFE">decode</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">                detected = chardet.detect(payload)</span></span>
<span class="line"><span style="color: #D4D4D4">                encoding = (</span></span>
<span class="line"><span style="color: #D4D4D4">                    detected&#91;</span><span style="color: #CE9178">&quot;encoding&quot;</span><span style="color: #D4D4D4">&#93;</span></span>
<span class="line"><span style="color: #D4D4D4">                    </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> detected&#91;</span><span style="color: #CE9178">&quot;encoding&quot;</span><span style="color: #D4D4D4">&#93; </span><span style="color: #569CD6">is</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">not</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">None</span></span>
<span class="line"><span style="color: #D4D4D4">                    </span><span style="color: #C586C0">else</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;utf-8&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">                )</span></span>
<span class="line"><span style="color: #D4D4D4">                </span><span style="color: #6A9955"># エラーの場合は文字化けしてでも文字列を出力</span></span>
<span class="line"><span style="color: #D4D4D4">                </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> payload.decode(encoding, </span><span style="color: #9CDCFE">errors</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;replace&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">else</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># メールの内容を取得</span></span>
<span class="line"><span style="color: #D4D4D4">        payload = msg.get_payload(</span><span style="color: #9CDCFE">decode</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># エンコード方式を確認</span></span>
<span class="line"><span style="color: #D4D4D4">        detected = chardet.detect(payload)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># 得られたエンコード方式がnoneならutf-8を、そうでなければ得られたものを採用</span></span>
<span class="line"><span style="color: #D4D4D4">        encoding = detected&#91;</span><span style="color: #CE9178">&quot;encoding&quot;</span><span style="color: #D4D4D4">&#93; </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> detected&#91;</span><span style="color: #CE9178">&quot;encoding&quot;</span><span style="color: #D4D4D4">&#93; </span><span style="color: #569CD6">is</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">not</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">else</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;utf-8&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># エラーの場合は文字化けしてでも文字列を出力</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> payload.decode(encoding, </span><span style="color: #9CDCFE">errors</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;replace&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">emlファイルから情報取得する流れは以下の通りです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>emlファイルをMessageオブジェクトとして取得する</li>



<li>欲しい情報を辞書のような形で取り出す</li>



<li>本文はマルチパート、シングルパート別に処理を変える</li>
</ol>
</div></div>



<p class="wp-block-paragraph">この流れをおさえた上で本記事の内容を参考にしていただければ、メールデータを簡単に取り出せるはずです。</p>



<p class="wp-block-paragraph">ご不明な点などありましたら、コメント欄にメッセージいただければご回答させていただきます。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【配布用】Python スクリプトを実行ファイル化する PyInstaller を徹底解説！</title>
		<link>https://cfxlog.com/python-pyinstaller-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 10 Mar 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[デプロイ]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4998</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-pyinstaller-guide.jpg" class="webfeedsFeaturedVisual" /></p>このような方に向けて書きました。 頑張って開発したアプリケーションを他の人に使っていただくときに、通常のアプリケーションのようにダブルクリックで起動する「実行ファイル」にしておくと親切です。 Pyhthon の実行ファイ [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-pyinstaller-guide.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Python で書いたスクリプトを配布したい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような方に向けて書きました。</p>



<p class="wp-block-paragraph">頑張って開発したアプリケーションを他の人に使っていただくときに、通常のアプリケーションのようにダブルクリックで起動する「実行ファイル」にしておくと親切です。</p>



<p class="wp-block-paragraph">Pyhthon の実行ファイル化ツールで最も利用されているのは PyInstaller です。</p>



<p class="wp-block-paragraph">初見ではオプションの指定方法や<code>.spec</code>ファイルの書き方など、なかなか理解できない箇所も多くあります。</p>



<p class="wp-block-paragraph">本記事では「これから PyInstaller で実行ファイル化したい！」という方に向けて、必要な知識や実行ファイル化の手順をわかりやすく解説します。</p>



<h2 class="wp-block-heading">PyInstaller の概要を解説</h2>



<p class="wp-block-paragraph">まずは、PyInstaller を使うために必要な前提知識からご紹介します。</p>



<h3 class="wp-block-heading"> PyInstallerの概要</h3>



<p class="wp-block-paragraph">PyInstaller は Python プログラムを「実行ファイル」に変換するツールです。</p>



<p class="wp-block-paragraph">Windows, Mac, Linux に対応しています。</p>



<p class="wp-block-paragraph">詳しくは後述しますが、<code>.spec</code>ファイルでビルドする際の挙動を調整できたり、細かい設定が効くので、配布用に変換するには絶好のツールです。</p>



<p class="wp-block-paragraph">ただし、出力される実行ファイルの容量は大きくなりがちなのがデメリットではあります。</p>



<h3 class="wp-block-heading">他のパッケージングツールと比較</h3>



<p class="wp-block-paragraph">他のパッケージングツールとの比較を表にまとめました。</p>



<figure class="wp-block-table"><table><thead><tr><th>ツール名</th><th>単一ファイル化</th><th>クロスプラットフォーム</th><th>ファイルサイズ</th><th>ビルド時間</th></tr></thead><tbody><tr><th>PyInstaller</th><td>○</td><td>○</td><td>×</td><td>△</td></tr><tr><th>py2exe</th><td>×</td><td>×（Winのみ）</td><td>△</td><td>○</td></tr><tr><th>cx_Freeze</th><td>×</td><td>○</td><td>×</td><td>○</td></tr><tr><th>py2app</th><td>×</td><td>×（Macのみ）</td><td>△</td><td>○</td></tr><tr><th>nuitka</th><td>○</td><td>○</td><td>○</td><td>×</td></tr></tbody></table><figcaption class="wp-element-caption">パッケージングツール比較</figcaption></figure>



<p class="wp-block-paragraph">海外では<code>nuitka</code>が使われることも多いようですが、設定が複雑なのでちょっと使いづらかったです。</p>



<p class="wp-block-paragraph">やっぱり<code>PyInstaller</code>が総合してバランスが取れていると思います。</p>



<h3 class="wp-block-heading">実行ファイルの構成</h3>



<p class="wp-block-paragraph">PyInstaller 実行後には、以下が出力されます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>dist/</strong>: 実行ファイルを格納</li>



<li><strong>build/</strong>: ビルドの一時ファイルを格納</li>



<li><strong>myscript.spec</strong>: ビルド内容に関する設定ファイル</li>
</ul>
</div></div>



<p class="wp-block-paragraph">具体的には以下のような構成です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Plaintext</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>my_project/
├── my_script.py
├── my_script.spec
├── build/
│   └── my_script/
│       ├── base_library.zip
│       ├── my_script.exe.manifest
│       ├── my_script.exe.pyi
│       ├── warn-my_script.txt
│       └── &lt;その他の中間ファイル>
└── dist/
    └── my_script/
        ├── my_script.exe
        ├── &lt;依存ファイル1>
        ├── &lt;依存ファイル2>
        └── &lt;その他の依存ファイル></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">my_project/</span></span>
<span class="line"><span style="color: #D4D4D4">├── my_script.py</span></span>
<span class="line"><span style="color: #D4D4D4">├── my_script.spec</span></span>
<span class="line"><span style="color: #D4D4D4">├── build/</span></span>
<span class="line"><span style="color: #D4D4D4">│   └── my_script/</span></span>
<span class="line"><span style="color: #D4D4D4">│       ├── base_library.zip</span></span>
<span class="line"><span style="color: #D4D4D4">│       ├── my_script.exe.manifest</span></span>
<span class="line"><span style="color: #D4D4D4">│       ├── my_script.exe.pyi</span></span>
<span class="line"><span style="color: #D4D4D4">│       ├── warn-my_script.txt</span></span>
<span class="line"><span style="color: #D4D4D4">│       └── &lt;その他の中間ファイル&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">└── dist/</span></span>
<span class="line"><span style="color: #D4D4D4">    └── my_script/</span></span>
<span class="line"><span style="color: #D4D4D4">        ├── my_script.exe</span></span>
<span class="line"><span style="color: #D4D4D4">        ├── &lt;依存ファイル1&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">        ├── &lt;依存ファイル2&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">        └── &lt;その他の依存ファイル&gt;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>.spec</code>ファイルについては、<a href="#build-by-spec">本記事の後半</a>で詳しく解説します。</p>



<h2 class="wp-block-heading">PyInstaller で実行ファイル化するまでの流れ</h2>



<p class="wp-block-paragraph">PyInstaller は Python プログラムをスタンドアロンの実行可能なファイル（.exe、.appなど）に変換するツールです。実行ファイル化には、以下の手順で行います。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li>インストール</li>



<li>Python スクリプトを用意する</li>



<li>PyInstaller の実行</li>
</ul>
</div></div>



<p class="wp-block-paragraph">順番に解説します。</p>



<h3 class="wp-block-heading">インストール</h3>



<p class="wp-block-paragraph">まずはお使いの環境に Python がインストールされているか確認します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>python --version

# 結果
# Python 3.11.7</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 結果</span></span>
<span class="line"><span style="color: #6A9955"># Python 3.11.7</span></span></code></pre></div>



<p class="wp-block-paragraph">バージョンが帰ってくれば、Python がインストールされているということなので次に進みましょう。</p>



<p class="wp-block-paragraph">続いて、PyInstaller のインストールをします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install pyinstaller</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pyinstaller</span></span></code></pre></div>



<p class="wp-block-paragraph">念の為以下のコマンドで、正常にPyInstaller がインストールされたか確認しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyinstaller --version

# 結果
# 6.6.0</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyinstaller</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 結果</span></span>
<span class="line"><span style="color: #6A9955"># 6.6.0</span></span></code></pre></div>



<p class="wp-block-paragraph">バージョンが返ってくればインストールは成功です！</p>



<h3 class="wp-block-heading">Python スクリプトを用意する</h3>



<p class="wp-block-paragraph">ごく簡単なスクリプトとして<code>myscript.py</code>を作ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>print("hello, world")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;hello, world&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">次の手順で、このスクリプトを実行ファイル化していきます。</p>



<h3 class="wp-block-heading">PyInstaller の実行</h3>



<p class="wp-block-paragraph">コマンドラインから、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyinstaller myscript.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyinstaller</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myscript.py</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>dist</code>フォルダと<code>build</code>フォルダが作成されて、<code>dist</code>フォルダ内に実行ファイルが生成されます。</p>



<p class="wp-block-paragraph">ちなみにコマンドにはオプションを設定することができます。</p>



<figure class="wp-block-table"><table><thead><tr><th>オプション</th><th>内容</th></tr></thead><tbody><tr><td><code>--onefile</code></td><td>単一の実行ファイルにまとめる</td></tr><tr><td><code>--noconsole</code></td><td>コンソールウィンドウを表示しない</td></tr><tr><td><code>--icon</code></td><td>実行ファイルのアイコンを指定する</td></tr><tr><td><code>--clean</code></td><td>キャッシュを削除する</td></tr></tbody></table><figcaption class="wp-element-caption">オプションの説明</figcaption></figure>



<p class="wp-block-paragraph">上記のオプションを使った場合のコマンド例はこちら。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyinstaller --onefile --noconsole --icon=my_icon.ico --clean myscript.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyinstaller</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--onefile</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--noconsole</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--icon=my_icon.ico</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--clean</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myscript.py</span></span></code></pre></div>



<p class="wp-block-paragraph">その他のオプションについては、公式ドキュメントをご参照ください。</p>



<p class="wp-block-paragraph"><a href="https://pyinstaller.org/en/stable/usage.html#options">» 参考：Using Pyinstaller &#8211; Options</a></p>



<h3 class="wp-block-heading">実行方法</h3>



<p class="wp-block-paragraph"><code>dist</code>フォルダ内に生成された実行可能ファイルを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>./dist/myscript</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">./dist/myscript</span></span></code></pre></div>



<p class="wp-block-paragraph">これで先ほどの<code>myscript</code>が実行され、<code>Hello, World!</code>の文字列が表示されるようになります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Hello, World!

Saving session...
...copying shared history...
...saving history...truncating history files...
...completed.

&#91;プロセスが完了しました&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">Hello,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">World!</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">Saving</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">session...</span></span>
<span class="line"><span style="color: #DCDCAA">..</span><span style="color: #D4D4D4">.copying </span><span style="color: #CE9178">shared</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">history...</span></span>
<span class="line"><span style="color: #DCDCAA">..</span><span style="color: #D4D4D4">.saving </span><span style="color: #CE9178">history...truncating</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">history</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">files...</span></span>
<span class="line"><span style="color: #DCDCAA">..</span><span style="color: #D4D4D4">.completed.</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">&#91;プロセスが完了しました&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">今回の場合にはコンソール上に<code>print()</code>するだけなので、実行ファイル化する際には<code>--noconsole</code>を入れないようにしましょう。</p>



<p class="wp-block-paragraph">入れてしまうと<code>print()</code>関数の結果が見られないためです。</p>



<h2 class="wp-block-heading" id="build-by-spec">spec ファイルを使ったビルド</h2>



<p class="wp-block-paragraph">PyInstaller では<code>--noconsole</code>などのオプションをつけてビルドを行うものが主流ですが、<code>.spec</code>ファイルでビルド内容を定義することができます。</p>



<p class="wp-block-paragraph">メリットは次のとおり。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>複雑な設定の管理</li>



<li>再利用性が向上</li>



<li>バージョン管理できる</li>
</ul>
</div></div>



<p class="wp-block-paragraph">何度もオプションを書いてビルドし直す、という面倒な作業がなくなります。</p>



<p class="wp-block-paragraph">以下、詳細を見ていきましょう。</p>



<h3 class="wp-block-heading">spec ファイルの生成方法</h3>



<p class="wp-block-paragraph"><code>.spec</code>ファイルは、通常のビルドコマンドを実行すると生成されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyinstaller myscript.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyinstaller</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myscript.py</span></span></code></pre></div>



<p class="wp-block-paragraph">myscript.specというファイルが出力されるので、内容を確認していきましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># -*- mode: python ; coding: utf-8 -*-

block_cipher = None

a = Analysis(
    &#91;'myscript.py'&#93;,
    pathex=&#91;'/path/to/your/script'&#93;,
    binaries=[],
    datas=[],
    hiddenimports=[],
    hookspath=[],
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
)
pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)

exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='myscript',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=True,
)
coll = COLLECT(
    exe,
    a.binaries,
    a.zipfiles,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='myscript',
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># -*- mode: python ; coding: utf-8 -*-</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">block_cipher</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">None</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">a</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Analysis</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    &#91;</span><span style="color: #CE9178">&apos;myscript.py&apos;</span><span style="color: #D4D4D4">&#93;</span><span style="color: #DCDCAA">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">pathex</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&#91;&apos;/path/to/your/script&apos;&#93;,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">datas</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">hiddenimports</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">hookspath</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">runtime_hooks</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">excludes</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">win_no_prefer_redirects</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">win_private_assemblies</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">cipher</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">block_cipher,</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #DCDCAA">pyz</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">PYZ</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">a.pure,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">a.zipped_data,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">cipher=block_cipher</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">exe</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">EXE</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">pyz,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.scripts,</span></span>
<span class="line"><span style="color: #D4D4D4">    []</span><span style="color: #DCDCAA">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">exclude_binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;myscript&apos;,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">debug</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">bootloader_ignore_signals</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">strip</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx_exclude</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">runtime_tmpdir</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">None,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">console</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #DCDCAA">coll</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">COLLECT</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">exe,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.binaries,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.zipfiles,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.datas,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">strip</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx_exclude</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;myscript&apos;,</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">specファイルを使ったビルド</h3>



<p class="wp-block-paragraph"><code>.spec</code>ファイルを使ってビルドする場合には、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyinstaller myscript.spec</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyinstaller</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myscript.spec</span></span></code></pre></div>



<p class="wp-block-paragraph">これで<code>.spec</code>ファイルの内容をもとに実行ファイルが出力されます。</p>



<h3 class="wp-block-heading">.spec ファイルのカスタマイズ</h3>



<p class="wp-block-paragraph"><code>.spec</code>ファイルをカスタマイズして、ビルドの内容を変更する方法をご紹介します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-good_list">
<li>単一ファイル出力</li>



<li>コンソールの非表示</li>



<li>アイコンの設定</li>
</ul>
</div></div>



<h4 class="wp-block-heading">単一ファイル出力</h4>



<p class="wp-block-paragraph"><code>onefile</code>オプションのように、単一ファイル出力する方法です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li><code>EXE</code>関数の<code>exclude_binaries</code>を<code>True</code></li>



<li><code>COLLECT</code>ステップを削除</li>
</ul>
</div></div>



<p class="wp-block-paragraph">以下のように、<code>.spec</code>ファイルを編集します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>exe = EXE(
    ・・・
    exclude_binaries=True,  # onefileオプション
    ・・・
)

# onefileのためにCOLLECTステップを削除</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">exe</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">EXE</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">・・・</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">exclude_binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># onefileオプション</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">・・・</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># onefileのためにCOLLECTステップを削除</span></span></code></pre></div>



<p class="wp-block-paragraph">仮に<code>exclude_binaries=False</code>とした場合、アプリの受付部分にあたる「実行ファイル」と実際のロジックを担当する「バイナリ」に分割されます。</p>



<p class="wp-block-paragraph">分割することで「各ファイルを独立して管理」できたり「ビルド時間やファイルサイズが小さくなる」というメリットもあります。</p>



<p class="wp-block-paragraph">ただし、配布時にはわかりやすさ重視で<code>onefile</code>オプションをつけることのほうが多いです。</p>



<h4 class="wp-block-heading">コンソールの非表示</h4>



<p class="wp-block-paragraph"><code>--noconsole</code>オプションと同じ設定を行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='myscript',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=False,  # noconsole オプション
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">exe</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">EXE</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">pyz,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.scripts,</span></span>
<span class="line"><span style="color: #D4D4D4">    []</span><span style="color: #DCDCAA">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">exclude_binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;myscript&apos;,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">debug</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">bootloader_ignore_signals</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">strip</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx_exclude</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">runtime_tmpdir</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">None,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">console</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># noconsole オプション</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">これでコンソールが非表示になります。GUIアプリなどはこの設定が良いです。</p>



<p class="wp-block-paragraph">逆に、あえてコンソールを表示させたい場合には<code>console=True</code>を指定しましょう。</p>



<h4 class="wp-block-heading">アイコンの設定</h4>



<p class="wp-block-paragraph"><code>EXE</code>セクションで<code>icon</code>パラメータを追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='myscript',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=True,
    icon='path/to/icon.ico'
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">exe</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">EXE</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">pyz,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.scripts,</span></span>
<span class="line"><span style="color: #D4D4D4">    []</span><span style="color: #DCDCAA">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">exclude_binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;myscript&apos;,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">debug</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">bootloader_ignore_signals</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">strip</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx_exclude</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">runtime_tmpdir</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">None,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">console</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">icon</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;path/to/icon.ico&apos;</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">デバッグとトラブルシューティングの方法</h2>



<p class="wp-block-paragraph">PyInstaller でよくあるエラーと対処法をご紹介します。</p>



<p class="wp-block-paragraph">また、実行ファイル化後のトラブルについても具体的な対策に触れていきましょう。</p>



<h3 class="wp-block-heading">ModuleNotFoundError</h3>



<p class="wp-block-paragraph">モジュールがビルド対象から外れてしまった場合に表示されるエラーです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ModuleNotFoundError: No module named 'some_module'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">ModuleNotFoundError:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">No</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">module</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">named</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;some_module&apos;</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合、<code>.spec</code>ファイルの<code>hiddenimports</code>にモジュールを追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># .specファイルの編集
a = Analysis(&#91;'my_script.py'&#93;,
             pathex=&#91;'/path/to/my_project'&#93;,
             hiddenimports=&#91;'some_module'&#93;,  # 見つからなかったモジュールを指定
             ...)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># .specファイルの編集</span></span>
<span class="line"><span style="color: #DCDCAA">a</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Analysis</span><span style="color: #D4D4D4">(&#91;</span><span style="color: #CE9178">&apos;my_script.py&apos;</span><span style="color: #D4D4D4">&#93;,</span></span>
<span class="line"><span style="color: #D4D4D4">             </span><span style="color: #9CDCFE">pathex</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&#91;&apos;/path/to/my_project&apos;&#93;,</span></span>
<span class="line"><span style="color: #D4D4D4">             </span><span style="color: #9CDCFE">hiddenimports</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&#91;&apos;some_module&apos;&#93;,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 見つからなかったモジュールを指定</span></span>
<span class="line"><span style="color: #D4D4D4">             </span><span style="color: #DCDCAA">...</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">ImportError</h3>



<p class="wp-block-paragraph">外部ライブラリのインポートに失敗した場合のエラーです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ImportError: DLL load failed: The specified module could not be found.</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">ImportError:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">DLL</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">load</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">failed:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">The</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">specified</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">module</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">could</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">not</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">be</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">found.</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>.spec</code>ファイルの<code>binaries</code>にライブラリのパスを追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># .specファイルの編集
binaries=&#91;('path/to/dll_or_shared_library', '.')&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># .specファイルの編集</span></span>
<span class="line"><span style="color: #9CDCFE">binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&#91;</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">&apos;path/to/dll_or_shared_library&apos;</span><span style="color: #DCDCAA">,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;.&apos;</span><span style="color: #D4D4D4">)</span><span style="color: #CE9178">&#93;</span></span></code></pre></div>



<h3 class="wp-block-heading">FileNotFoundError</h3>



<p class="wp-block-paragraph">指定されたファイルパスが間違っている場合のエラーです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>FileNotFoundError: &#91;Errno 2&#93; No such file or directory: 'some_file'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">FileNotFoundError:</span><span style="color: #D4D4D4"> &#91;Errno </span><span style="color: #B5CEA8">2</span><span style="color: #CE9178">&#93;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">No</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">such</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">file</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">or</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">directory:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;some_file&apos;</span></span></code></pre></div>



<p class="wp-block-paragraph">datasにデータファイルの絶対パスを追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># .specファイルの編集
datas=&#91;('path/to/datafile', 'destination_directory')&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># .specファイルの編集</span></span>
<span class="line"><span style="color: #9CDCFE">datas</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&#91;</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">&apos;path/to/datafile&apos;</span><span style="color: #DCDCAA">,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;destination_directory&apos;</span><span style="color: #D4D4D4">)</span><span style="color: #CE9178">&#93;</span></span></code></pre></div>



<h3 class="wp-block-heading">デバッグモードの使用</h3>



<p class="wp-block-paragraph">PyInstaller のデバッグモードを使うことで、詳細なログを見ることができます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyinstaller --onefile --debug=all my_script.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyinstaller</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--onefile</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--debug=all</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">my_script.py</span></span></code></pre></div>



<p class="wp-block-paragraph">デバッグモードには二種類あります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>all</code>: すべてのデバッグ情報を有効にします。</li>



<li><code>noarchive</code>: アーカイブファイルを生成せず、すべてのファイルを展開された状態で保持します。これにより、ファイルの読み込みエラーを容易に特定できます。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これにより、コンソール上に詳細なログが表示されるようになります。</p>



<p class="wp-block-paragraph">どこで問題が起きたかがわかるので、とても便利です。</p>



<h3 class="wp-block-heading">Python スクリプト内でログ出力する</h3>



<p class="wp-block-paragraph">アプリケーション実行中のエラーは、スクリプト内にログ出力するようにすることでも対応できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import logging

logging.basicConfig(level=logging.DEBUG)
logging.debug("This is a debug message")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> logging</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">logging.basicConfig(</span><span style="color: #9CDCFE">level</span><span style="color: #D4D4D4">=logging.DEBUG)</span></span>
<span class="line"><span style="color: #D4D4D4">logging.debug(</span><span style="color: #CE9178">&quot;This is a debug message&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">※ ログ出力の方法については、後日別記事でご紹介する予定です。</p>



<h2 class="wp-block-heading">【アドバンス】PyInstaller が行う処理の流れ</h2>



<p class="wp-block-paragraph"><code>spec</code>ファイルを読み前提知識として、PyInstaller の処理の流れを理解しておきましょう。</p>



<p class="wp-block-paragraph">以下の順番で処理が流れていき、実行ファイルが生成されます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li>ファイルを分析</li>



<li>PYZ オブジェクトを作成</li>



<li>EXE オブジェクトを作成</li>



<li>すべてのファイルを統合</li>
</ul>
</div></div>



<p class="wp-block-paragraph">順番に解説していきます。</p>



<h3 class="wp-block-heading">ファイルを分析</h3>



<p class="wp-block-paragraph">実行ファイル化したい Python スクリプトを含む、すべてのファイルを調べるフェーズです。</p>



<p class="wp-block-paragraph"><code>.spec</code>ファイルでは、<code>Analysis</code>オブジェクトとして表現されてます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>a = Analysis(
    &#91;'myscript.py'&#93;,  # 対象の Python スクリプト名
    pathex=&#91;'/path/to/your/script'&#93;,  # スクリプトのパスを指定
    binaries=[],  # 追加のバイナリファイル(DLL, SOファイル)
    datas=[],  # 追加のデータファイル(画像、設定ファイルなど)
    hiddenimports=[],  # PyInstaller が自動検出できないモジュールのリスト
    hookspath=[],  # カスタムフックファイル
    runtime_hooks=[],  # アプリ実行時に実行されるスクリプトのリスト
    excludes=[],  # PyInstaller に含めないモジュールリスト
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">a</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Analysis</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    &#91;</span><span style="color: #CE9178">&apos;myscript.py&apos;</span><span style="color: #D4D4D4">&#93;</span><span style="color: #DCDCAA">,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 対象の Python スクリプト名</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">pathex</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&#91;&apos;/path/to/your/script&apos;&#93;,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># スクリプトのパスを指定</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 追加のバイナリファイル(DLL, SOファイル)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">datas</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 追加のデータファイル(画像、設定ファイルなど)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">hiddenimports</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># PyInstaller が自動検出できないモジュールのリスト</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">hookspath</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># カスタムフックファイル</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">runtime_hooks</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># アプリ実行時に実行されるスクリプトのリスト</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">excludes</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">[],</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># PyInstaller に含めないモジュールリスト</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合には、<code>/path/to/your/script</code>から<code>myscript.py</code>を探して、これを実行ファイル化します。</p>



<p class="is-style-icon_announce wp-block-paragraph">複数のスクリプトで構築した場合には、最初に指定したスクリプトが最初に実行されるエントリーポイントになります。</p>



<h3 class="wp-block-heading">PYZ オブジェクトを作成</h3>



<p class="wp-block-paragraph">続いては、Analysis で対象とされた Python ファイルをアーカイブにまとめます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyz = PYZ(a.pure, a.zipped_data)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyz</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">PYZ</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">a.pure,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">a.zipped_data</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>a.pure</code>は<code>Analysis</code>で取得された純粋な Python スクリプトのリストです。</p>



<p class="wp-block-paragraph"><code>a.zipped_data</code>はそれ以外のファイル群で、Python モジュールが依存している圧縮ファイルなどが指定されます。</p>



<p class="is-style-icon_announce wp-block-paragraph">いずれにせよ<code>PYZ</code>オブジェクトは PyInstaller のビルド時に自動的に出力されるものなので、手動でいじることはほとんどないです。</p>



<h3 class="wp-block-heading">EXE オブジェクトを作成</h3>



<p class="wp-block-paragraph">実際の実行ファイルを作成するステップです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>exe = EXE(
    pyz,  # 一つ前のステップで作成した PYZ オブジェクト
    a.scripts,  # Analysis オブジェクトで解析されたスクリプト
    [],  # 追加の Python スクリプトを指定する場合に必要
    exclude_binaries=False,  # バイナリと実行ファイルを分離しない
    name='myscript',  # 実行ファイルの名前
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">exe</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">EXE</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">pyz,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 一つ前のステップで作成した PYZ オブジェクト</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.scripts,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># Analysis オブジェクトで解析されたスクリプト</span></span>
<span class="line"><span style="color: #D4D4D4">    []</span><span style="color: #DCDCAA">,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 追加の Python スクリプトを指定する場合に必要</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">exclude_binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># バイナリと実行ファイルを分離しない</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;myscript&apos;,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 実行ファイルの名前</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">すべてのファイルを統合</h3>



<p class="wp-block-paragraph"><code>COLLECT</code>では、<code>Analysis</code>と<code>EXE</code>をまとめて「最終的なディレクトリ構造」を作成します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>coll = COLLECT(
    exe,  # 先に作成したEXEオブジェクト
    a.binaries,  # 解析されたバイナリのリスト
    a.zipfiles,  # 解析された圧縮ファイルのリスト
    a.datas,  # 解析されたエータファイルのリスト
    strip=False,  # デバッグ情報等を含めない
    upx=True,  # True にすると UPX で圧縮
    name='myscript',  # 出力ディレクトリ名を指定
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">coll</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">COLLECT</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">exe,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 先に作成したEXEオブジェクト</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.binaries,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 解析されたバイナリのリスト</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.zipfiles,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 解析された圧縮ファイルのリスト</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.datas,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 解析されたエータファイルのリスト</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">strip</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">False,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># デバッグ情報等を含めない</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">upx</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># True にすると UPX で圧縮</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;myscript&apos;,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 出力ディレクトリ名を指定</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>onefile</code>オプションをつけた場合には、<code>COLLECT</code>ステップがありません。</p>



<p class="wp-block-paragraph">そのため、<code>EXE</code>には以下のようになっているはずです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,  # これがonefileに相当
    name='myscript',
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">exe</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">EXE</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">pyz,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">a.scripts,</span></span>
<span class="line"><span style="color: #D4D4D4">    []</span><span style="color: #DCDCAA">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">exclude_binaries</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">True,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># これがonefileに相当</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;myscript&apos;,</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">補足：こんなときにどうする？</h2>



<p class="wp-block-paragraph">PyInstallerを使っていると、たまに問題に出くわすことがあります。</p>



<p class="wp-block-paragraph">このセクションでは、Q＆A形式でお答えしていきます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<dl class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-custom">
<div class="swell-block-faq__item"><dt class="faq_q">インポートしたはずのモジュールがなぜかビルドされていない<br></dt><dd class="faq_a">
<p class="wp-block-paragraph">通常はインポートされたモジュールも一緒にビルドされますが、PyInstaller が自動的に認識できない場合もあります。</p>



<p class="wp-block-paragraph">このような場合には、追加されないモジュールを明示します。</p>



<p class="wp-block-paragraph"><code>.spec</code>ファイルで指定する場合には、以下になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>a = Analysis(
    ・・・
    hiddenimports=&#91;'module1', 'module2'&#93;,  # ここに隠しインポートを追加
    ・・・
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">a</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Analysis</span><span style="color: #D4D4D4">(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">・・・</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">hiddenimports</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&#91;&apos;module1&apos;,</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">&apos;module2&apos;</span><span style="color: #DCDCAA">&#93;,</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># ここに隠しインポートを追加</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">・・・</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">オプションで指定するなら、以下です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyinstaller --hidden-import=module1 --hidden-import=module2 myscript.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pyinstaller</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--hidden-import=module1</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--hidden-import=module2</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myscript.py</span></span></code></pre></div>



<p class="wp-block-paragraph">これで、PyInstaller の解析で拾いきれなかったモジュールもビルド対象に含まれます。</p>
</dd></div>



<div class="swell-block-faq__item"><dt class="faq_q">セキュリティ対策はどうしたら良い？</dt><dd class="faq_a">
<p class="wp-block-paragraph">PyInstaller でできるセキュリティ対策には、例えば以下があります。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-good_list">
<li>UPX圧縮の使用</li>



<li>難読化ツールの使用</li>



<li>機密情報は環境変数から読み込む</li>
</ul>
</div></div>



<p class="wp-block-paragraph">UPX圧縮については<code>.spec</code>ファイルの<code>EXE</code>で指定できます。これによって一応は解析が難しくなりますが、万全な対策ではありません。</p>



<p class="wp-block-paragraph">より高度な難読化については、<code>PyArmor</code>や<code>PyObfuscate</code>を検討してみてください。</p>



<p class="wp-block-paragraph">また機密情報を含めると漏洩リスクがあるので、以下のように環境変数から読むと安全性が高まります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import os
api_key = os.getenv("API_KEY")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> os</span></span>
<span class="line"><span style="color: #D4D4D4">api_key = os.getenv(</span><span style="color: #CE9178">&quot;API_KEY&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>
</dd></div>
</dl>
</div></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">PuInstaller は、以下の内容を理解しておくと全体像が把握しやすいです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>処理の流れ（Analysis =&gt; PYZ =&gt; EXE =&gt; COL）</li>



<li><code>.spec</code>ファイルの内容理解</li>



<li>デバッグの方法</li>



<li>他のOSに配布する際のテクニック</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ぜひ、参考にしてみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【完全ガイド】Python で Word を自動操作する【win32com 】</title>
		<link>https://cfxlog.com/python-win32com-word/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 30 Dec 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<category><![CDATA[自動化]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4902</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-win32com-word.jpg" class="webfeedsFeaturedVisual" /></p>Windows環境でWordがインストールされている方向けの記事です。 win32com を活用すれば、Word 文書（.docx / .doc / .rtf）を生成・編集・検索置換・表作成・画像挿入・PDF変換までフル [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-win32com-word.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">Windows環境でWordがインストールされている方向けの記事です。</p>



<p class="wp-block-paragraph"><code>win32com</code> を活用すれば、Word 文書（.docx / .doc / .rtf）を<strong>生成・編集・検索置換・表作成・画像挿入・PDF変換</strong>までフルに自動化できます。</p>



<p class="wp-block-paragraph">本記事では、その方法をご紹介します。</p>



<h2 class="wp-block-heading">1. 事前準備（pywin32 インストール）</h2>



<h3 class="wp-block-heading">pywin32 のインストール</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install pywin32</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">pip install pywin32</span></span></code></pre></div>



<h3 class="wp-block-heading">Word を起動する基本コード</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from win32com.client import Dispatch, constants

word = Dispatch("Word.Application")
word.Visible = True</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> win32com.client </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Dispatch, constants</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">word = Dispatch(</span><span style="color: #CE9178">&quot;Word.Application&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">word.Visible = </span><span style="color: #569CD6">True</span></span></code></pre></div>



<h3 class="wp-block-heading">Word を終了</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>word.Quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">word.Quit()</span></span></code></pre></div>



<h2 class="wp-block-heading">2. Word.Application・Documents 操作</h2>



<h3 class="wp-block-heading">文書を新規作成</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc = word.Documents.Add()
doc.Content.Text = "Hello from Python!"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc = word.Documents.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">doc.Content.Text = </span><span style="color: #CE9178">&quot;Hello from Python!&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">既存文書を開く</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc = word.Documents.Open(r"C:\path\to\doc.docx")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">o\doc.docx&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">上書き保存 / 別名保存</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Save()  # 上書き

doc.SaveAs(r"C:\path\to\new.docx")  # 別名保存</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Save()  </span><span style="color: #6A9955"># 上書き</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">doc.SaveAs(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">o</span><span style="color: #D7BA7D">\n</span><span style="color: #D16969">ew.docx&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 別名保存</span></span></code></pre></div>



<h3 class="wp-block-heading">PDF として保存</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>wdFormatPDF = 17
doc.SaveAs(r"C:\path\to\out.pdf", FileFormat=wdFormatPDF)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">wdFormatPDF = </span><span style="color: #B5CEA8">17</span></span>
<span class="line"><span style="color: #D4D4D4">doc.SaveAs(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">o</span><span style="color: #D7BA7D">\o</span><span style="color: #D16969">ut.pdf&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">FileFormat</span><span style="color: #D4D4D4">=wdFormatPDF)</span></span></code></pre></div>



<p class="wp-block-paragraph">変換したPDFから、今度は逆にテキストを抽出したり中身を操作したりしたい場合は、PyPDFを使うと便利です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-pypdf-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-pypdf-guide/">pypdfの使い方｜インストール・テキスト抽出・結合・分割を解説</a>
						<span class="p-blogCard__excerpt">Python で PDF を扱いたい！ テキスト抽出・結合・分割を自動化したい！ PyPDF と PyPDF2 の違いが知りたい！ PyPDF2 の古いコードを pypdf に書き換えたい！ このよう&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">文書を閉じる</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Close(SaveChanges=False)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Close(</span><span style="color: #9CDCFE">SaveChanges</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">3. Range / Selection の基本操作</h2>



<h3 class="wp-block-heading">文書全体のテキスト取得・書き込み</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>text = doc.Content.Text
doc.Content.Text = "上書き内容"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">text = doc.Content.Text</span></span>
<span class="line"><span style="color: #D4D4D4">doc.Content.Text = </span><span style="color: #CE9178">&quot;上書き内容&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">文末に追記する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>end = doc.Content.End
doc.Range(end, end).InsertAfter("\n追記しました")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">end = doc.Content.End</span></span>
<span class="line"><span style="color: #D4D4D4">doc.Range(end, end).InsertAfter(</span><span style="color: #CE9178">&quot;</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">追記しました&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">文頭に挿入</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Range(0, 0).InsertBefore("=== 先頭に追記 ===\n")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">).InsertBefore(</span><span style="color: #CE9178">&quot;=== 先頭に追記 ===</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">書式設定（太字・色・サイズ）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>rng = doc.Range(0, 10)
rng.Font.Bold = True
rng.Font.Color = 255
rng.Font.Size = 16</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">rng = doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">rng.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">rng.Font.Color = </span><span style="color: #B5CEA8">255</span></span>
<span class="line"><span style="color: #D4D4D4">rng.Font.Size = </span><span style="color: #B5CEA8">16</span></span></code></pre></div>



<h2 class="wp-block-heading">4. 検索・置換（Find / Replace）</h2>



<h3 class="wp-block-heading">単純置換（文書全体）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>find = doc.Content.Find
find.Text = "旧社名"
find.Replacement.Text = "新社名"
find.Execute(Replace=constants.wdReplaceAll)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">find = doc.Content.Find</span></span>
<span class="line"><span style="color: #D4D4D4">find.Text = </span><span style="color: #CE9178">&quot;旧社名&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.Replacement.Text = </span><span style="color: #CE9178">&quot;新社名&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.Execute(</span><span style="color: #9CDCFE">Replace</span><span style="color: #D4D4D4">=constants.wdReplaceAll)</span></span></code></pre></div>



<h3 class="wp-block-heading">ワイルドカード（正規表現風）の利用</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>find = doc.Content.Find
find.Text = "&#91;0-9&#93;{4}/&#91;0-9&#93;{2}/&#91;0-9&#93;{2}"
find.MatchWildcards = True
find.Replacement.Text = "****/**/**"
find.Execute(Replace=constants.wdReplaceAll)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">find = doc.Content.Find</span></span>
<span class="line"><span style="color: #D4D4D4">find.Text = </span><span style="color: #CE9178">&quot;&#91;0-9&#93;</span><span style="color: #569CD6">{4}</span><span style="color: #CE9178">/&#91;0-9&#93;</span><span style="color: #569CD6">{2}</span><span style="color: #CE9178">/&#91;0-9&#93;</span><span style="color: #569CD6">{2}</span><span style="color: #CE9178">&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.MatchWildcards = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">find.Replacement.Text = </span><span style="color: #CE9178">&quot;****/**/**&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.Execute(</span><span style="color: #9CDCFE">Replace</span><span style="color: #D4D4D4">=constants.wdReplaceAll)</span></span></code></pre></div>



<h2 class="wp-block-heading">5. 段落操作</h2>



<h3 class="wp-block-heading">段落を列挙する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>for p in doc.Paragraphs:
    print(p.Range.Text)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> p </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> doc.Paragraphs:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(p.Range.Text)</span></span></code></pre></div>



<h3 class="wp-block-heading">段落の書式設定</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>p = doc.Paragraphs(1)
p.Alignment = constants.wdAlignParagraphCenter
p.Range.Font.Bold = True
p.Range.Font.Size = 14</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">p = doc.Paragraphs(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">p.Alignment = constants.wdAlignParagraphCenter</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Font.Size = </span><span style="color: #B5CEA8">14</span></span></code></pre></div>



<h3 class="wp-block-heading">改行を挿入</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Range().InsertParagraphAfter()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Range().InsertParagraphAfter()</span></span></code></pre></div>



<h2 class="wp-block-heading">6. 箇条書き・番号リスト</h2>



<h3 class="wp-block-heading">箇条書きにする</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>p = doc.Paragraphs.Add()
p.Range.Text = "箇条書き項目"
p.Range.ListFormat.ApplyBulletDefault()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">p = doc.Paragraphs.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Text = </span><span style="color: #CE9178">&quot;箇条書き項目&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.ListFormat.ApplyBulletDefault()</span></span></code></pre></div>



<h3 class="wp-block-heading">番号付きリストにする</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>p = doc.Paragraphs.Add()
p.Range.Text = "番号リスト項目"
p.Range.ListFormat.ApplyNumberDefault()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">p = doc.Paragraphs.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Text = </span><span style="color: #CE9178">&quot;番号リスト項目&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.ListFormat.ApplyNumberDefault()</span></span></code></pre></div>



<h2 class="wp-block-heading">7. 表（Table）操作</h2>



<h3 class="wp-block-heading">表を作成する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>table = doc.Tables.Add(
    Range=doc.Range(0, 0),
    NumRows=3,
    NumColumns=3
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">table = doc.Tables.Add(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Range</span><span style="color: #D4D4D4">=doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">),</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">NumRows</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">NumColumns</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">3</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">セルへ値を設定</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>table.Cell(1, 1).Range.Text = "商品名"
table.Cell(1, 2).Range.Text = "数量"
table.Cell(1, 3).Range.Text = "金額"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">table.Cell(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">).Range.Text = </span><span style="color: #CE9178">&quot;商品名&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">table.Cell(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">).Range.Text = </span><span style="color: #CE9178">&quot;数量&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">table.Cell(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">).Range.Text = </span><span style="color: #CE9178">&quot;金額&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">行・列を追加</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>table.Rows.Add()
table.Columns.Add()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">table.Rows.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">table.Columns.Add()</span></span></code></pre></div>



<h3 class="wp-block-heading">ヘッダー行の書式設定</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>header = table.Rows(1)
header.Range.Font.Bold = True
header.Shading.BackgroundPatternColor = 12632256</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">header = table.Rows(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">header.Range.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">header.Shading.BackgroundPatternColor = </span><span style="color: #B5CEA8">12632256</span></span></code></pre></div>



<h2 class="wp-block-heading">8. 画像・図形の挿入</h2>



<h3 class="wp-block-heading">画像を挿入</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>inline = doc.Range(0, 0).InlineShapes.AddPicture(
    FileName=r"C:\path\image.png",
    LinkToFile=False,
    SaveWithDocument=True
)
inline.Width = 300
inline.Height = 200</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">inline = doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">).InlineShapes.AddPicture(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">FileName</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\i</span><span style="color: #D16969">mage.png&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">LinkToFile</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">SaveWithDocument</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">inline.Width = </span><span style="color: #B5CEA8">300</span></span>
<span class="line"><span style="color: #D4D4D4">inline.Height = </span><span style="color: #B5CEA8">200</span></span></code></pre></div>



<h3 class="wp-block-heading">図形（シェイプ）を追加</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>shape = doc.Shapes.AddShape(
    Type=1,
    Left=50,
    Top=50,
    Width=200,
    Height=100
)
shape.TextFrame.TextRange.Text = "図形のテキスト"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">shape = doc.Shapes.AddShape(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Type</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Left</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">50</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Top</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">50</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Width</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">200</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Height</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">100</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">shape.TextFrame.TextRange.Text = </span><span style="color: #CE9178">&quot;図形のテキスト&quot;</span></span></code></pre></div>



<h2 class="wp-block-heading">9. ヘッダー・フッター操作</h2>



<h3 class="wp-block-heading">ヘッダーを編集する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>section = doc.Sections(1)
header = section.Headers(constants.wdHeaderFooterPrimary)
header.Range.Text = "会社名：Python自動化株式会社"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">section = doc.Sections(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">header = section.Headers(constants.wdHeaderFooterPrimary)</span></span>
<span class="line"><span style="color: #D4D4D4">header.Range.Text = </span><span style="color: #CE9178">&quot;会社名：Python自動化株式会社&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">フッター（ページ番号）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>footer = section.Footers(constants.wdHeaderFooterPrimary)
footer.Range.Text = "Page "
footer.PageNumbers.Add(constants.wdAlignParagraphRight)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">footer = section.Footers(constants.wdHeaderFooterPrimary)</span></span>
<span class="line"><span style="color: #D4D4D4">footer.Range.Text = </span><span style="color: #CE9178">&quot;Page &quot;</span></span>
<span class="line"><span style="color: #D4D4D4">footer.PageNumbers.Add(constants.wdAlignParagraphRight)</span></span></code></pre></div>



<h2 class="wp-block-heading">10. スタイル操作</h2>



<h3 class="wp-block-heading">見出しスタイルを適用</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Range(0, 10).Style = "見出し 1"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">).Style = </span><span style="color: #CE9178">&quot;見出し 1&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">カスタムスタイルの作成</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>styles = doc.Styles
st = styles.Add("PythonTitle", constants.wdStyleTypeParagraph)
st.Font.Size = 20
st.Font.Bold = True
st.ParagraphFormat.Alignment = constants.wdAlignParagraphCenter</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">styles = doc.Styles</span></span>
<span class="line"><span style="color: #D4D4D4">st = styles.Add(</span><span style="color: #CE9178">&quot;PythonTitle&quot;</span><span style="color: #D4D4D4">, constants.wdStyleTypeParagraph)</span></span>
<span class="line"><span style="color: #D4D4D4">st.Font.Size = </span><span style="color: #B5CEA8">20</span></span>
<span class="line"><span style="color: #D4D4D4">st.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">st.ParagraphFormat.Alignment = constants.wdAlignParagraphCenter</span></span></code></pre></div>



<h2 class="wp-block-heading">11. 差し込み文書（Mail Merge）</h2>



<h3 class="wp-block-heading">テンプレートとデータソースを紐付ける</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc = word.Documents.Open(r"C:\template.docx")
doc.MailMerge.OpenDataSource(
    Name=r"C:\data.xlsx",
    ConfirmConversions=False,
    ReadOnly=True
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">emplate.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">doc.MailMerge.OpenDataSource(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Name</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:\data.xlsx&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">ConfirmConversions</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">ReadOnly</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">差し込み処理を実行</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.MailMerge.Execute()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.MailMerge.Execute()</span></span></code></pre></div>



<h2 class="wp-block-heading">12. コメント・変更履歴</h2>



<h3 class="wp-block-heading">コメントを追加</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Comments.Add(doc.Range(0, 10), "ここを修正")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Comments.Add(doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">), </span><span style="color: #CE9178">&quot;ここを修正&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">変更履歴をオンにする</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.TrackRevisions = True</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.TrackRevisions = </span><span style="color: #569CD6">True</span></span></code></pre></div>



<h3 class="wp-block-heading">履歴の一括承認／拒否</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.AcceptAllRevisions()
# doc.RejectAllRevisions()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.AcceptAllRevisions()</span></span>
<span class="line"><span style="color: #6A9955"># doc.RejectAllRevisions()</span></span></code></pre></div>



<h2 class="wp-block-heading">13. 文書比較（Compare）</h2>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc1 = word.Documents.Open(r"C:\old.docx")
doc2 = word.Documents.Open(r"C:\new.docx")

result = word.CompareDocuments(doc1, doc2)
result.SaveAs(r"C:\comparison.docx")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc1 = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\o</span><span style="color: #D16969">ld.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">doc2 = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\n</span><span style="color: #D16969">ew.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">result = word.CompareDocuments(doc1, doc2)</span></span>
<span class="line"><span style="color: #D4D4D4">result.SaveAs(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\c</span><span style="color: #D16969">omparison.docx&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">14. その他：アプリケーション制御</h2>



<h3 class="wp-block-heading">警告を抑制</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>word.DisplayAlerts = False</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">word.DisplayAlerts = </span><span style="color: #569CD6">False</span></span></code></pre></div>



<h3 class="wp-block-heading">Word を安全に終了（finally）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>try:
    word = Dispatch("Word.Application")
    doc = word.Documents.Open(r"C:\doc.docx")

finally:
    doc.Close(SaveChanges=False)
    word.Quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">try</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    word = Dispatch(</span><span style="color: #CE9178">&quot;Word.Application&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    doc = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:\doc.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">finally</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    doc.Close(</span><span style="color: #9CDCFE">SaveChanges</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    word.Quit()</span></span></code></pre></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Word は Excel や Outlook と比べてもテンプレ書類が多く、<strong>自動化の効果が大きい分野</strong>です。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>契約書テンプレへ自動差し込み</li>



<li>Word → PDF 自動生成</li>



<li>表・画像・図形・スタイル操作</li>



<li>変更履歴・コメント・文書比較</li>



<li>MailMerge（差し込み文書）</li>
</ul>
</div></div>



<p class="wp-block-paragraph">まで、<strong>業務用書類の自動生成</strong>を Python で完結できます。</p>



<p class="wp-block-paragraph">ぜひ、本記事の内容を参考に自動化に取り組んでみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django REST framework】画像ファイルアップロード機能の実装方法</title>
		<link>https://cfxlog.com/django-drf-upload-image/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 28 Jun 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5230</guid>

					<description><![CDATA[Django REST framework（以下、「DRF」とします）で画像アップロード機能を実装するには、いくつかのステップが必要になります。 これらのステップをできる限り単純化して、わかりやすく解説していきます。 実 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django REST framework で画像アップロード機能を実装したい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Django REST framework（以下、「DRF」とします）で画像アップロード機能を実装するには、いくつかのステップが必要になります。</p>



<p class="wp-block-paragraph">これらのステップをできる限り単純化して、わかりやすく解説していきます。</p>



<p class="wp-block-paragraph">実装の全体的な流れから確認していきます。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list">
<li>モデルの作成</li>

<li>シリアライザの作成</li>

<li>ビューの作成</li>

<li>URL のルーティング</li>

<li>フロントエンドの実装</li>

<li>settings.py の整備</li>
</ol>
</div></div>



<p class="wp-block-paragraph">それぞれの手順について、必要性もあわせて詳しく解説します。</p>



<p class="wp-block-paragraph">画像ファイルを格納するモデルを用意します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db import models

class ImageModel(models.Model):
    # 画像ファイルのパスが格納される
    image = models.ImageField(upload_to="images/")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.db </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> models</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ImageModel</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">models</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">Model</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#6A9955">    # 画像ファイルのパスが格納される</span></span>
<span class="line"><span style="color:#D4D4D4">    image = models.ImageField(</span><span style="color:#9CDCFE">upload_to</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"images/"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">今回は画像を保存するので ImageField とし、upload_to という引数を設定しておきます。<br/>この upload_to には、画像を格納するディレクトリを指定できます。</p>



<p class="wp-block-paragraph">上記のサンプルコードでは image/ としています。この場合は MEDIA_ROOT で設定したディレクトリの下に image/ ディレクトリを掘って、その下に画像ファイルを保存されます。</p>



<p class="wp-block-paragraph">まずは serializers.py をアプリディレクトリ配下に作成します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>myproject/
    app/
        __init__.py
        models.py
        views.py
        serializers.py   # 追加
        urls.py
        ...
    myproject/
        settings.py
        urls.py
        ...
    manage.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">myproject/</span></span>
<span class="line"><span style="color:#DCDCAA">    app/</span></span>
<span class="line"><span style="color:#DCDCAA">        __init__.py</span></span>
<span class="line"><span style="color:#DCDCAA">        models.py</span></span>
<span class="line"><span style="color:#DCDCAA">        views.py</span></span>
<span class="line"><span style="color:#DCDCAA">        serializers.py</span><span style="color:#6A9955">   # 追加</span></span>
<span class="line"><span style="color:#DCDCAA">        urls.py</span></span>
<span class="line"><span style="color:#DCDCAA">        ...</span></span>
<span class="line"><span style="color:#DCDCAA">    myproject/</span></span>
<span class="line"><span style="color:#DCDCAA">        settings.py</span></span>
<span class="line"><span style="color:#DCDCAA">        urls.py</span></span>
<span class="line"><span style="color:#DCDCAA">        ...</span></span>
<span class="line"><span style="color:#DCDCAA">    manage.py</span></span></code></pre></div>



<p class="wp-block-paragraph">ここで気になるのが、「シリアライザって何者？」ということだと思います。</p>



<p class="wp-block-paragraph">シリアライザの主な役割は次の二つです。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained"></div></div>



<p class="wp-block-paragraph">今回はアップロードされた画像を受け取るケースなので、JSONからモデルインスタンスに変換する時に使われます。</p>



<p class="wp-block-paragraph">他にもバリデーションができたり Form 的な要素もあるのですが、この段階では上記の理解で十分です。</p>



<p class="wp-block-paragraph">では、serializers.py の中身を見ていきましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework import serializers
from .models import ImageModel

class ImageModelSerializer(serializers.ModelSerializer):
    class Meta:
        model = ImageModel
        fields = ["image"]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> serializers</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> ImageModel</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ImageModelSerializer</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">serializers</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">ModelSerializer</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    class</span><span style="color:#4EC9B0"> Meta</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">        model = ImageModel</span></span>
<span class="line"><span style="color:#D4D4D4">        fields = [</span><span style="color:#CE9178">"image"</span><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">シリアライザにはいくつかの種類がありますが、今回はモデルインスタンスに対応するシリアライザである ModelSerializer を採用しました。</p>



<p class="wp-block-paragraph">なお、今回のようなモデルベースのシリアライザでは Meta クラスの設定が必須になります。</p>



<p class="wp-block-paragraph">model には対応するモデルを指定してください。</p>



<p class="wp-block-paragraph">fields にはシリアライザとして受け入れたいフィールドの種類を指定します。例えば、シリアライザで画像データを受け入れつつ、他にもフィールドにも登録をしたい場合には登録したいフィールドをリストに渡しておくこととなります。</p>



<p class="is-style-icon_announce wp-block-paragraph">すべてのフィールドをシリアライザとして受け入れたい場合には、fields = “__all__” として指定できます。</p>



<p class="wp-block-paragraph">画像データを受け入れる際のロジックを views.py に書いていきましょう。ここでは最も基本的な APIView クラスを継承した例を掲載します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework import status
from rest_framework.response import Response
from rest_framework.views import APIView
from .models import ImageModel
from .serializers import ImageModelSerializer

class ImageUploadView(APIView):
    def post(self, request, *args, **kwargs):
        file_serializer = ImageModelSerializer(data=request.data)
        if file_serializer.is_valid():
            file_serializer.save()
            return Response(file_serializer.data, status=status.HTTP_201_CREATED)
        else:
            return Response(file_serializer.errors, status=status.HTTP_400_BAD_REQUEST)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> status</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.response </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Response</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> APIView</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> ImageModel</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .serializers </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> ImageModelSerializer</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ImageUploadView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">APIView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> post</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">, *</span><span style="color:#9CDCFE">args</span><span style="color:#D4D4D4">, **</span><span style="color:#9CDCFE">kwargs</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        file_serializer = ImageModelSerializer(</span><span style="color:#9CDCFE">data</span><span style="color:#D4D4D4">=request.data)</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#D4D4D4"> file_serializer.is_valid():</span></span>
<span class="line"><span style="color:#D4D4D4">            file_serializer.save()</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#D4D4D4"> Response(file_serializer.data, </span><span style="color:#9CDCFE">status</span><span style="color:#D4D4D4">=status.HTTP_201_CREATED)</span></span>
<span class="line"><span style="color:#C586C0">        else</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#D4D4D4"> Response(file_serializer.errors, </span><span style="color:#9CDCFE">status</span><span style="color:#D4D4D4">=status.HTTP_400_BAD_REQUEST)</span></span></code></pre></div>



<p class="wp-block-paragraph">request.data は DRF ならではの属性で、リクエストボディが格納された辞書のようなオブジェクトです。これをシリアライザに渡すことで、画像ファイルを読み込むことができます。</p>



<p class="wp-block-paragraph">ここで生成した file_serializer に対してバリデーション（is_valid）をしたり、モデルインスタンスを保存（save）したりすることができるようになります。</p>



<p class="wp-block-paragraph">ここでは file_serializer.data をレスポンスとして返しています。この中には、例えば画像ファイルへのURLなどが含まれることになります。</p>



<p class="wp-block-paragraph">file_serializers.errors のようにすると、バリデーションで失敗した内容が返されます。</p>



<p class="wp-block-paragraph">urls.py 内でエンドポイントの URL を定義します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path
from .views import ImageUploadView

urlpatterns = [
    path("upload/", ImageUploadView.as_view(), name="file-upload"),
]

# 開発用
if settings.DEBUG:
    urlpatterns += static(
        settings.MEDIA_URL,
        document_root=settings.MEDIA_ROOT,
    )</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> ImageUploadView</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"upload/"</span><span style="color:#D4D4D4">, ImageUploadView.as_view(), </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"file-upload"</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 開発用</span></span>
<span class="line"><span style="color:#C586C0">if</span><span style="color:#D4D4D4"> settings.DEBUG:</span></span>
<span class="line"><span style="color:#D4D4D4">    urlpatterns += static(</span></span>
<span class="line"><span style="color:#D4D4D4">        settings.MEDIA_URL,</span></span>
<span class="line"><span style="color:#9CDCFE">        document_root</span><span style="color:#D4D4D4">=settings.MEDIA_ROOT,</span></span>
<span class="line"><span style="color:#D4D4D4">    )</span></span></code></pre></div>



<p class="wp-block-paragraph">DEBUG 時にだけ if 文を組んでいるのは、本番ではアプリケーションサーバーを介さずにウェブサーバーから配信するからです。</p>



<p class="wp-block-paragraph">また、MEDIA_ROOT と MEDIA_URL についても少し補足します。MEDIA_ROOT は、画像ファイルが物理的にサーバー上のどこに保存されるかを指定するものです。一方で MEDIA_URL は、MEDIA_ROOT で指定されたディレクトリにアクセスするための URL になります。</p>



<p class="wp-block-paragraph">static() 関数は、静的ファイルへのアクセスに使われるメソッドぐらいに考えておけば OK です。</p>



<p class="wp-block-paragraph">フロント側は色々な実装が考えられると思いますが、fetch 関数を使った例を挙げます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">JavaScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>const formData = new FormData();
formData.append('image', fileInput.files[0]);

fetch('http://yourserver.com/upload/', {
    method: 'POST',
    body: formData
})
.then(response =&gt; response.json())
.then(data =&gt; console.log(data))
.then(error =&gt; console.error(error));</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">const</span><span style="color:#4FC1FF"> formData</span><span style="color:#D4D4D4"> = </span><span style="color:#569CD6">new</span><span style="color:#DCDCAA"> FormData</span><span style="color:#D4D4D4">();</span></span>
<span class="line"><span style="color:#9CDCFE">formData</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">append</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">'image'</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">fileInput</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">files</span><span style="color:#D4D4D4">[</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">]);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#DCDCAA">fetch</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">'http://yourserver.com/upload/'</span><span style="color:#D4D4D4">, {</span></span>
<span class="line"><span style="color:#9CDCFE">    method:</span><span style="color:#CE9178"> 'POST'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#9CDCFE">    body:</span><span style="color:#9CDCFE"> formData</span></span>
<span class="line"><span style="color:#D4D4D4">})</span></span>
<span class="line"><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">then</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">response</span><span style="color:#569CD6"> =></span><span style="color:#9CDCFE"> response</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">json</span><span style="color:#D4D4D4">())</span></span>
<span class="line"><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">then</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">data</span><span style="color:#569CD6"> =></span><span style="color:#9CDCFE"> console</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">log</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">data</span><span style="color:#D4D4D4">))</span></span>
<span class="line"><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">then</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">error</span><span style="color:#569CD6"> =></span><span style="color:#9CDCFE"> console</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">error</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">error</span><span style="color:#D4D4D4">));</span></span></code></pre></div>



<p class="wp-block-paragraph">最後に settings.py に以下の項目を追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>MEDIA_URL = "/media/"
MEDIA_ROOT = BASE_DIR / "media"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">MEDIA_URL = </span><span style="color:#CE9178">"/media/"</span></span>
<span class="line"><span style="color:#D4D4D4">MEDIA_ROOT = BASE_DIR / </span><span style="color:#CE9178">"media"</span></span></code></pre></div>



<p class="wp-block-paragraph">前述の通り、MEDIA_ROOT はサーバー上の保存場所を、MEDIA_URL は、MEDIA_ROOT で指定されたディレクトリにアクセスするための URL を制御するものになります。</p>



<p class="wp-block-paragraph">これまでの手順で画像アップロード機能の実装は問題なくできますが、もう一歩進んだ実装を組み込みたい方向けにアドバンス的なテクニックをご紹介します。</p>



<p class="wp-block-paragraph">先ほどの方法では、保存するディレクトリは指定できてもファイル名の指定はできませんでした。</p>



<p class="wp-block-paragraph">この場合、次のような問題が起こる可能性があります。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ファイル名が衝突する</li>

<li>URLが予測されてしまう</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ユーザーがアップロードした画像の名前がそのままサーバー上でのファイル名になってしまうので、画像のファイル名が衝突を起こす可能性があります。<br/>そして URL にファイル名が含まれることになるので、ファイル名が予測されることによりセキュリティが甘くなってしまう可能性を孕みます。</p>



<p class="wp-block-paragraph">これを回避するために使われるのが、upload_to オプションです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from uuid import uuid4
from django.db import models

def upload_to(instance, filename):
    # 拡張子を取得
    ext = filename.split(".")[-1]  
    # ファイル名としてUUIDを生成し、元の拡張子を維持
    filename = f"{uuid4()}.{ext}"
    # images/ディレクトリに保存されるようにパスを返す
    return f"images/{filename}"

class ImageModel(models.Model):
    # upload_toにupload_to関数を指定
    image = models.ImageField(upload_to=upload_to)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> uuid </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> uuid4</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.db </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> models</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> upload_to</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">instance</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">filename</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#6A9955">    # 拡張子を取得</span></span>
<span class="line"><span style="color:#D4D4D4">    ext = filename.split(</span><span style="color:#CE9178">"."</span><span style="color:#D4D4D4">)[-</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">]  </span></span>
<span class="line"><span style="color:#6A9955">    # ファイル名としてUUIDを生成し、元の拡張子を維持</span></span>
<span class="line"><span style="color:#D4D4D4">    filename = </span><span style="color:#569CD6">f</span><span style="color:#CE9178">"</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">uuid4()</span><span style="color:#569CD6">}</span><span style="color:#CE9178">.</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">ext</span><span style="color:#569CD6">}</span><span style="color:#CE9178">"</span></span>
<span class="line"><span style="color:#6A9955">    # images/ディレクトリに保存されるようにパスを返す</span></span>
<span class="line"><span style="color:#C586C0">    return</span><span style="color:#569CD6"> f</span><span style="color:#CE9178">"images/</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">filename</span><span style="color:#569CD6">}</span><span style="color:#CE9178">"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ImageModel</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">models</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">Model</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#6A9955">    # upload_toにupload_to関数を指定</span></span>
<span class="line"><span style="color:#D4D4D4">    image = models.ImageField(</span><span style="color:#9CDCFE">upload_to</span><span style="color:#D4D4D4">=upload_to)</span></span></code></pre></div>



<p class="wp-block-paragraph">上記のように upload_to() 関数を用意して、ImageField(upload_to=upload_to) のように渡してあげます。これにより uuid4 で生成された文字列でファイル名が決まるので、ファイル名の衝突を避けてセキュリティも担保できるようになります。</p>



<p class="wp-block-paragraph">クライアントから送られてくる画像は、極端にサイズの大きなものもあります。<br/>そのような場合に無条件にデータを受け入れてしまうと、サーバーのストレージを圧迫したり、APIの通信速度にも影響が出てくるでしょう。</p>



<p class="wp-block-paragraph">そこで、画像を受け入れるときにファイルサイズを小さくするロジックを組むと良いです。</p>



<p class="wp-block-paragraph">方法はいくつかありますが、ここでは storage_backend.py を使った方法をご紹介します。</p>



<p class="wp-block-paragraph">まず、storage_backend.py を以下の場所に作成します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>myproject/
    app/
        __init__.py
        models.py
        views.py
        serializers.py
        storage_backend.py   # 追加
        urls.py
        ...
    myproject/
        settings.py
        urls.py
        ...
    manage.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">myproject/</span></span>
<span class="line"><span style="color:#DCDCAA">    app/</span></span>
<span class="line"><span style="color:#DCDCAA">        __init__.py</span></span>
<span class="line"><span style="color:#DCDCAA">        models.py</span></span>
<span class="line"><span style="color:#DCDCAA">        views.py</span></span>
<span class="line"><span style="color:#DCDCAA">        serializers.py</span></span>
<span class="line"><span style="color:#DCDCAA">        storage_backend.py</span><span style="color:#6A9955">   # 追加</span></span>
<span class="line"><span style="color:#DCDCAA">        urls.py</span></span>
<span class="line"><span style="color:#DCDCAA">        ...</span></span>
<span class="line"><span style="color:#DCDCAA">    myproject/</span></span>
<span class="line"><span style="color:#DCDCAA">        settings.py</span></span>
<span class="line"><span style="color:#DCDCAA">        urls.py</span></span>
<span class="line"><span style="color:#DCDCAA">        ...</span></span>
<span class="line"><span style="color:#DCDCAA">    manage.py</span></span></code></pre></div>



<p class="wp-block-paragraph">このモジュールの中に、画像を save した後にサイズを縮小するというロジックを書いていきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.core.files.storage import FileSystemStorage
from PIL import Image

class ImageResizeStorage(FileSystemStorage):
    def save(self, name, content, *args, **kwargs):
        name = super().save(name, content, *args, **kwargs)

        max_size = 300
        full_path = self.path(name)
        with Image.open(full_path) as img:
            img.thumbnail((max_size, max_size))
            img.save(full_path)
        return name</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.core.files.storage </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> FileSystemStorage</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> PIL </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Image</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ImageResizeStorage</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">FileSystemStorage</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> save</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">content</span><span style="color:#D4D4D4">, *</span><span style="color:#9CDCFE">args</span><span style="color:#D4D4D4">, **</span><span style="color:#9CDCFE">kwargs</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        name = </span><span style="color:#4EC9B0">super</span><span style="color:#D4D4D4">().save(name, content, *args, **kwargs)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">        max_size = </span><span style="color:#B5CEA8">300</span></span>
<span class="line"><span style="color:#D4D4D4">        full_path = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.path(name)</span></span>
<span class="line"><span style="color:#C586C0">        with</span><span style="color:#D4D4D4"> Image.open(full_path) </span><span style="color:#C586C0">as</span><span style="color:#D4D4D4"> img:</span></span>
<span class="line"><span style="color:#D4D4D4">            img.thumbnail((max_size, max_size))</span></span>
<span class="line"><span style="color:#D4D4D4">            img.save(full_path)</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> name</span></span></code></pre></div>



<p class="wp-block-paragraph">さらに、このロジックを models.py で定義した ImageField に加えていきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>image = models.ImageField(
    upload_to=upload_to,
    storage = ImageResizeStorage(),
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">image = models.ImageField(</span></span>
<span class="line"><span style="color:#9CDCFE">    upload_to</span><span style="color:#D4D4D4">=upload_to,</span></span>
<span class="line"><span style="color:#9CDCFE">    storage</span><span style="color:#D4D4D4"> = ImageResizeStorage(),</span></span>
<span class="line"><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">以上で、画像を保存するたびに大きい画像であればリサイズしてくれる機能を実装することができます。</p>



<p class="wp-block-paragraph">ここでの注意点は、この処理は画像保存のたびに同期的に行われるということです。つまり、トラフィックの多いサイトや、画像が頻繁に飛んでくるようなサイトの場合にはパフォーマンスが低下するおそれがあります。</p>



<p class="wp-block-paragraph">そのような場合にはCeleryなどを使って非同期で処理する仕組み実装するのが良いと思います。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Python × Excel自動化】openpyxlでグラフが消える問題を解決｜win32comで書式を保持して操作する方法</title>
		<link>https://cfxlog.com/python-win32com-excel/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 08 Jan 2023 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[Excel自動化]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<guid isPermaLink="false">https://www.cfxlog.com/?p=74</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/AdobeStock_504301962-768x446-1.jpg" class="webfeedsFeaturedVisual" /></p>Python の Excel 系ライブラリは openpyxl が有名です。 ところが、openpyxl はグラフや罫線などが消えてしまう不具合があり、クライアントワークなどで安全に自動化したい場合はちょっと怖い面も。  [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/AdobeStock_504301962-768x446-1.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">Python の Excel 系ライブラリは openpyxl が有名です。</p>



<p class="wp-block-paragraph">ところが、<strong>openpyxl はグラフや罫線などが消えてしまう不具合</strong>があり、クライアントワークなどで安全に自動化したい場合はちょっと怖い面も。</p>



<p class="wp-block-paragraph">そこで便利なのが win32com というライブラリ。</p>



<p class="wp-block-paragraph">win32com は Excel のマクロと同じくらいの安定性があるので安心です。</p>



<p class="wp-block-paragraph">注意点としては、Excel （Office）のインストールが必須なことと、openpyxl に比べて速度は遅めな点。</p>



<p class="wp-block-paragraph">また、macOS では動作しません。<br>macOS で安全に Excel 操作をしたい場合には xlwings というライブラリを使うことになります。</p>



<p class="wp-block-paragraph">ちなみに win32com を使うと Outlook の自動化もできます。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/win32com_outlook_eyecatch-768x403-1-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-win32com-outlook/">【Python】win32comを使ったOutlook操作のすべて</a>
						<span class="p-blogCard__excerpt">Windows でメール自動化をしたい Python で Outlook を操作したい Windows 環境なら Outlook を操作することで間接的にメールの操作ができます。 とはいえ、Python から&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">今回ご紹介する Excel 操作のコードは、Excel VBA のものとほぼ同じです。</p>



<h2 class="wp-block-heading">win32comでExcel操作をする流れとサンプルコード</h2>



<p class="wp-block-paragraph">細かい実装方法の前に、win32com を使って Excel を自動化する際の全体像からお見せしたいと思います。</p>



<p class="wp-block-paragraph">全体の流れは次の通りです。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>win32comライブラリのインストール</li>



<li>インポート</li>



<li>Excelアプリケーションの呼び出し</li>



<li>ブックの呼び出し</li>



<li>シートの呼び出し</li>



<li>自動化したい操作</li>
</ol>
</div></div>



<p class="wp-block-paragraph">まずはステップ①として、以下のコードをコマンドプロンプト上<span class="swl-fz u-fz-xs">（または仮想環境上）</span>で実行して、win32com ライブラリをインストールします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install pywin32</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> pywin32</span></span></code></pre></div>



<p class="wp-block-paragraph">あとは実装したい内容に即してコードを書いていくだけです。</p>



<p class="wp-block-paragraph">まずは簡単な例として、A1 セルに「テスト」という文字列を入力して保存するコードをご紹介します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client
import getpass

user_name = getpass.getuser()
book_path = rf'C:¥Users¥{user_name}¥Documents¥book.xlsx'

# ExcelAppのインスタンス化
excel = win32com.client.Dispatch("Excel.Application")
excel.Visible = False  # 画面非表示 
excel.DisplayAlerts = False # 警告非表示

# ブック / シートの呼び出し
wb = excel.Workbooks.Open(book_path)
ws = wb.Worksheets(1)  # 一番左のシート

# A1セルにテストと入力
ws.Range('A1').Value = 'テスト'

ws.Save()
ws.Close()

# ExcelAppインスタンスの解放
excel.Quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> getpass</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">user_name = getpass.getuser()</span></span>
<span class="line"><span style="color:#D4D4D4">book_path = </span><span style="color:#569CD6">rf</span><span style="color:#CE9178">'C:¥Users¥</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">user_name</span><span style="color:#569CD6">}</span><span style="color:#CE9178">¥Documents¥book.xlsx'</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># ExcelAppのインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">excel = win32com.client.Dispatch(</span><span style="color:#CE9178">"Excel.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">excel.Visible = </span><span style="color:#569CD6">False</span><span style="color:#6A9955">  # 画面非表示 </span></span>
<span class="line"><span style="color:#D4D4D4">excel.DisplayAlerts = </span><span style="color:#569CD6">False</span><span style="color:#6A9955"> # 警告非表示</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># ブック / シートの呼び出し</span></span>
<span class="line"><span style="color:#D4D4D4">wb = excel.Workbooks.Open(book_path)</span></span>
<span class="line"><span style="color:#D4D4D4">ws = wb.Worksheets(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 一番左のシート</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># A1セルにテストと入力</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Value = </span><span style="color:#CE9178">'テスト'</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">ws.Save()</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Close()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># ExcelAppインスタンスの解放</span></span>
<span class="line"><span style="color:#D4D4D4">excel.Quit()</span></span></code></pre></div>



<p class="wp-block-paragraph">では、詳細の説明に入っていきます。</p>



<h2 class="wp-block-heading">事前準備</h2>



<p class="wp-block-paragraph">win32com を使う準備として、大きく3ステップがあります。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>ライブラリのインストール<span class="swl-fz u-fz-xs">（コンソール上）</span></li>



<li>インポート</li>



<li>Excel APPの呼び出し</li>
</ul>
</div></div>



<p class="wp-block-paragraph">お気づきの方もいらっしゃるかもですが、一般的なライブラリの使い方と同じです。</p>



<p class="is-style-icon_info wp-block-paragraph">Python 環境は構築済みであることが前提です。</p>



<h3 class="wp-block-heading">ライブラリのインストール</h3>



<p class="wp-block-paragraph">プロジェクトの最初に一度だけ、以下のコマンドを実行してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install pywin32</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> pywin32</span></span></code></pre></div>



<p class="wp-block-paragraph">もしバージョン管理ツールのpoetryを使いたい場合には<code>poetry add pywin32</code>とします。</p>



<p class="wp-block-paragraph">poetryを使ってみたい！という方は以下の記事も参考にしてみてください。僕は通常pipではなく、poetryを使っています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-poetry-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-poetry-guide/">【Poetry使い方から仮想環境の削除まで】Pythonパッケージ管理の完全ガイド</a>
						<span class="p-blogCard__excerpt">Poetry ってどんなもの？ インストール方法が知りたい 使い方を詳しく教えて欲しい 最近では、pip の代わりに Poetry を導入する Python プロジェクトが増えてきました&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="is-style-icon_info wp-block-paragraph">ライブラリ名は win32com ではなく、pywin32 なのでお間違いなきよう！</p>



<h3 class="wp-block-heading">インポート</h3>



<p class="wp-block-paragraph">続いてインポートです。<br>Excel 自動化の際には<code>win32com.client</code>をインポートしておくと便利です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span></code></pre></div>



<p class="wp-block-paragraph">上記だけで動かない場合には、追加で<code>pythoncom</code>を呼び出すと動く場合があります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import pythoncom
pythoncom.CoInitialize()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> pythoncom</span></span>
<span class="line"><span style="color:#D4D4D4">pythoncom.CoInitialize()</span></span></code></pre></div>



<p class="wp-block-paragraph">pythoncom は Python 上から COM オブジェクトを操作するのに必要な機能を提供するものです。その意味では呼び出し必須…とも思えるのですが、なぜか僕の環境では pythoncom なしで動きます。</p>



<p class="wp-block-paragraph">win32com.client 単体で動かなければ pythoncom を呼び出す、くらいに考えておけば良いと思います。</p>



<h3 class="wp-block-heading">Excel APP の呼び出し</h3>



<p class="wp-block-paragraph">続いてExcel アプリケーションを呼び出します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># ExcelAppのインスタンス化
excel = win32com.client.Dispatch("Excel.Application")
excel.Visible = False  # 画面非表示 
excel.DisplayAlerts = False # 警告非表示</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># ExcelAppのインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">excel = win32com.client.Dispatch(</span><span style="color:#CE9178">"Excel.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">excel.Visible = </span><span style="color:#569CD6">False</span><span style="color:#6A9955">  # 画面非表示 </span></span>
<span class="line"><span style="color:#D4D4D4">excel.DisplayAlerts = </span><span style="color:#569CD6">False</span><span style="color:#6A9955"> # 警告非表示</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の例では Excel アプリケーション呼び出しと同時に、自動処理中の画面の非表示と警告の非表示<span class="swl-fz u-fz-xs">（「保存しますか？」などと聞かれるダイアログを無効化）</span>を加えています。</p>



<p class="wp-block-paragraph">こちらは必要に応じて True、False を切り替えてお使いください。</p>



<p class="wp-block-paragraph">コードの最後には Excel アプリケーションを終了するため、次のコマンドを書いておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>excel.Quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">excel.Quit()</span></span></code></pre></div>



<p class="wp-block-paragraph">終了処理は意外と見落としがちですが、これがないと Excel アプリケーションがバックグラウンドで起動しっぱなしになり、色々不都合が出るので必須です。</p>



<p class="wp-block-paragraph">途中でエラーが起こりそうなら、finally として Quit 文を追加しておくことも多いです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>try:
    # 処理内容を書く
except:
    # 例外処理
finally:
    excel.Quit</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">try</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#6A9955">    # 処理内容を書く</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#6A9955">    # 例外処理</span></span>
<span class="line"><span style="color:#C586C0">finally</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">    excel.Quit</span></span></code></pre></div>



<h2 class="wp-block-heading">ブックの操作</h2>



<p class="wp-block-paragraph">ブック / シートの操作は次のような種類があります。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>開く</li>



<li>新規作成</li>



<li>保存</li>



<li>削除</li>



<li>閉じる</li>
</ul>
</div></div>



<h3 class="wp-block-heading">ブックを開く</h3>



<p class="wp-block-paragraph">基本の開き方は以下の通りです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># ブックを開く
wb = excel.Workbooks.Open(book_path)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># ブックを開く</span></span>
<span class="line"><span style="color:#D4D4D4">wb = excel.Workbooks.Open(book_path)</span></span></code></pre></div>



<p class="wp-block-paragraph">引数を設定することで「パスワード保護」「読み取り専用」「外部参照リンクの更新」などのオプションも細かく指定できます。</p>



<p class="wp-block-paragraph">詳しくは公式ドキュメントをご参照ください。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>公式ドキュメント</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li><strong><a href="https://learn.microsoft.com/ja-jp/office/vba/api/excel.workbooks.open">Workbooks.Open メソッド (Excel)</a></strong></li>
</ul>
</div></div>



<h3 class="wp-block-heading">ブックを新規作成する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># ブックを新規作成
wb = Workbooks.Add()

# 名前をつけて保存
wb.SaveAs(book_path)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># ブックを新規作成</span></span>
<span class="line"><span style="color:#D4D4D4">wb = Workbooks.Add()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 名前をつけて保存</span></span>
<span class="line"><span style="color:#D4D4D4">wb.SaveAs(book_path)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>Add</code>をしただけでは実際のファイルは作成されません。<br>そのため、xlsxファイルとして保存する際には<code>SaveAs</code>を使います。</p>



<h3 class="wp-block-heading">ブックを保存する</h3>



<p class="wp-block-paragraph">保存には「上書き保存」と「名前をつけて保存」の2パターンがあります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 上書き保存
wb.Save()

# 名前をつけて保存
wb.SaveAs(book_path)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 上書き保存</span></span>
<span class="line"><span style="color:#D4D4D4">wb.Save()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 名前をつけて保存</span></span>
<span class="line"><span style="color:#D4D4D4">wb.SaveAs(book_path)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>SaveAs</code>の場合は保存先のパスを引数に渡します。</p>



<h3 class="wp-block-heading">ブックを削除する</h3>



<p class="wp-block-paragraph">ブックごと削除する場合は<code>os</code>ライブラリの<code>remove</code>を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import os

# ブックを削除する
os.remove(book_path)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> os</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># ブックを削除する</span></span>
<span class="line"><span style="color:#D4D4D4">os.remove(book_path)</span></span></code></pre></div>



<h3 class="wp-block-heading">ブックを閉じる</h3>



<p class="wp-block-paragraph">開いたファイルは、最終的に閉じましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>wb.Close()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">wb.Close()</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>Save</code>等で保存した後にも忘れずに閉じるようにします。</p>



<h2 class="wp-block-heading">シートの操作</h2>



<p class="wp-block-paragraph">シート操作には次のようなものがあります。</p>



<ul class="wp-block-list is-style-check_list">
<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>開く</li>



<li>追加</li>



<li>シート名変更</li>



<li>削除</li>



<li>全シートを取得</li>
</ul>
</div></div>
</ul>



<h3 class="wp-block-heading">シートを開く</h3>



<p class="wp-block-paragraph">シート名、またはシート番号から操作したいシートを選択します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 名前からシートを開く
ws = wb.Worksheets("Sheet1")
# 番号からシートを開く
ws = wb.Worksheets(1)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 名前からシートを開く</span></span>
<span class="line"><span style="color:#D4D4D4">ws = wb.Worksheets(</span><span style="color:#CE9178">"Sheet1"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#6A9955"># 番号からシートを開く</span></span>
<span class="line"><span style="color:#D4D4D4">ws = wb.Worksheets(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">シート番号から指定する場合、一番左のシートは1です。<span class="swl-fz u-fz-xs">（Pythonのように0始まりではないので注意）</span></p>



<h3 class="wp-block-heading">シートを追加する</h3>



<p class="wp-block-paragraph">シートを追加する場合、新しいシートの追加位置を指定します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 一番左のシートを取得
ws = excel.Sheets(1)

# 一番左にシートを追加する
excel.Sheets.Add(Before=ws)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 一番左のシートを取得</span></span>
<span class="line"><span style="color:#D4D4D4">ws = excel.Sheets(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 一番左にシートを追加する</span></span>
<span class="line"><span style="color:#D4D4D4">excel.Sheets.Add(</span><span style="color:#9CDCFE">Before</span><span style="color:#D4D4D4">=ws)</span></span></code></pre></div>



<p class="wp-block-paragraph">あるシートの右側に新しいシートを追加したい場合には、次のように書きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 一番左のシートを取得
ws = excel.Sheets(1)

# 2番目にシートを追加する
excel.Sheets.Add(Before=None, After=ws)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 一番左のシートを取得</span></span>
<span class="line"><span style="color:#D4D4D4">ws = excel.Sheets(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 2番目にシートを追加する</span></span>
<span class="line"><span style="color:#D4D4D4">excel.Sheets.Add(</span><span style="color:#9CDCFE">Before</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">None</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">After</span><span style="color:#D4D4D4">=ws)</span></span></code></pre></div>



<p class="wp-block-paragraph">ここで<code>Before=None</code>を書かないとうまく動作しないので注意が必要です。</p>



<p class="wp-block-paragraph">通常は名前付き引数として<code>After</code>としているので動作するはずですが、win32comでは名前付き引数がうまく機能しないので上記のような配慮が必要になります。</p>



<h3 class="wp-block-heading">シート名を変更する</h3>



<p class="wp-block-paragraph">シートを追加すると同時にシート名を変更することが多いです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># シート名を変更する
ws.Name = '新しいシート名'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># シート名を変更する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Name = </span><span style="color:#CE9178">'新しいシート名'</span></span></code></pre></div>



<h3 class="wp-block-heading">シートを削除</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># シートを削除する
ws.Delete()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># シートを削除する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Delete()</span></span></code></pre></div>



<h3 class="wp-block-heading">ブック内の全シートを取得</h3>



<p class="wp-block-paragraph">全シートを取得するには、Worksheetsを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 全シート名をprintする
for ws in wb.Worksheets:
    print(ws.Name)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4"># 全シート名をprintする</span></span>
<span class="line"><span style="color:#D4D4D4">for ws in wb.Worksheets:</span></span>
<span class="line"><span style="color:#D4D4D4">    print(ws.Name)</span></span></code></pre></div>



<p class="wp-block-paragraph">もう少しスッキリ書くならリスト内包表記を使いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 全シート名をprintする
[print(ws.Name) for ws in wb.Worksheets]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 全シート名をprintする</span></span>
<span class="line"><span style="color:#D4D4D4">[</span><span style="color:#DCDCAA">print</span><span style="color:#D4D4D4">(ws.Name) </span><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> ws </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> wb.Worksheets]</span></span></code></pre></div>



<p class="wp-block-paragraph">もちろん、if文を組み合わせて条件に応じて操作方法を分けるといった方法も有効です。</p>



<h2 class="wp-block-heading">セルの操作方法</h2>



<p class="wp-block-paragraph">Excelのセル操作とは、例えば次のようなものです。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>値を入力 / 取得する</li>



<li>セルの書式設定をする</li>



<li>背景色や文字色などを変更する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">コードの書き方としてはそこまで難しいものではないので、一つずつ丁寧に解説していきます。</p>



<h3 class="wp-block-heading">セルに値を入力する</h3>



<p class="wp-block-paragraph">まずはA1セルに「テスト」という文字列を入力する例を見ていきます。</p>



<p class="wp-block-paragraph">直感的にわかりやすいのは<code>Range</code>メソッドを使った方法です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># A2セルに値を入力する
ws.Range('A2').Value = 'テスト'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># A2セルに値を入力する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A2'</span><span style="color:#D4D4D4">).Value = </span><span style="color:#CE9178">'テスト'</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の他に、win32com（VBA）では<code>Cells</code>メソッドも用意されており、次のように書くとA1セルに「テスト」という文字列を入力できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># A2セルに値を入力する
ws.Cells(2, 1).Value = 'テスト'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># A2セルに値を入力する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Cells(</span><span style="color:#B5CEA8">2</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">).Value = </span><span style="color:#CE9178">'テスト'</span></span></code></pre></div>



<p class="wp-block-paragraph">Cellsの第一引数に行番号を、第二引数に列番号を渡します。</p>



<p class="wp-block-paragraph">直感的にはRangeの方がわかりやすいものの、次のような変数を使って入力先のセルを動的に変化させたい時にはCellsメソッドの方が便利です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 値を入力する行列番号を変数に格納
row_num = 10
col_num = 5

# 値をセルに入力する
ws.Cells(row_num, col_num).Value = 'テスト'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 値を入力する行列番号を変数に格納</span></span>
<span class="line"><span style="color:#D4D4D4">row_num = </span><span style="color:#B5CEA8">10</span></span>
<span class="line"><span style="color:#D4D4D4">col_num = </span><span style="color:#B5CEA8">5</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 値をセルに入力する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Cells(row_num, col_num).Value = </span><span style="color:#CE9178">'テスト'</span></span></code></pre></div>



<h3 class="wp-block-heading">複数セルに値を入力する</h3>



<p class="wp-block-paragraph">特定の範囲内のセルに「同じ値」を入力したい場合は以下のようにします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># A1セルからB5セルまで値を入力する
ws.Range('A1:B5').Value = 'テスト'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># A1セルからB5セルまで値を入力する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1:B5'</span><span style="color:#D4D4D4">).Value = </span><span style="color:#CE9178">'テスト'</span></span></code></pre></div>



<p class="wp-block-paragraph">各セルに違う値を入力したい場合には、次のような感じでリスト型として渡せばOKです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 代入する値をリストで用意
cells_list = [[1, 2], [3, 4], [5, 6], [7, 8], [9, 10]]

# A1からB5セルまで値を入力する
ws.Range('A1:B5').Value = cells_list</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 代入する値をリストで用意</span></span>
<span class="line"><span style="color:#D4D4D4">cells_list = [[</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">2</span><span style="color:#D4D4D4">], [</span><span style="color:#B5CEA8">3</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">4</span><span style="color:#D4D4D4">], [</span><span style="color:#B5CEA8">5</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">], [</span><span style="color:#B5CEA8">7</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">8</span><span style="color:#D4D4D4">], [</span><span style="color:#B5CEA8">9</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">10</span><span style="color:#D4D4D4">]]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># A1からB5セルまで値を入力する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1:B5'</span><span style="color:#D4D4D4">).Value = cells_list</span></span></code></pre></div>



<p class="wp-block-paragraph">また、セル範囲の指定に変数を使いたい場合は以下のようにRangeとCellsを組み合わせて使うと簡単です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># セル番号をセット
start_row = 1
start_col = 2
end_row = 5
end_col = 5

# 文字列を入力する
ws.Range(ws.Cells(start_row, start_col), ws.Cells(end_row, end_col)).Value = 'テスト'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># セル番号をセット</span></span>
<span class="line"><span style="color:#D4D4D4">start_row = </span><span style="color:#B5CEA8">1</span></span>
<span class="line"><span style="color:#D4D4D4">start_col = </span><span style="color:#B5CEA8">2</span></span>
<span class="line"><span style="color:#D4D4D4">end_row = </span><span style="color:#B5CEA8">5</span></span>
<span class="line"><span style="color:#D4D4D4">end_col = </span><span style="color:#B5CEA8">5</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 文字列を入力する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(ws.Cells(start_row, start_col), ws.Cells(end_row, end_col)).Value = </span><span style="color:#CE9178">'テスト'</span></span></code></pre></div>



<h3 class="wp-block-heading">関数を入力する</h3>



<p class="wp-block-paragraph">関数を入力する場合は、Valueの代わりにFormulaにします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># A2からA10セルの合計値をA1セルに表示する
ws.Range('A1').Formula = "=SUM('A2:A10')"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># A2からA10セルの合計値をA1セルに表示する</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Formula = </span><span style="color:#CE9178">"=SUM('A2:A10')"</span></span></code></pre></div>



<h2 class="wp-block-heading">セルの書式設定</h2>



<p class="wp-block-paragraph">表示形式を変えたり罫線や色を変更する方法を紹介します。</p>



<h3 class="wp-block-heading">フォントの設定</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># フォントサイズ
ws.Range('A1').Font.Size = 12

# 太字
ws.Range('A1').Font.Bold = True
# イタリック
ws.Range('A1').Font.Italic = True
# 下線
ws.Range('A1').Font.Underline = True
# 取消線
ws.Range('A1').Font.Strikethrough = True

# 文字色
vbRed = 0xFF
ws.Range('A1').Font.Color = vbRed</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># フォントサイズ</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Font.Size = </span><span style="color:#B5CEA8">12</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 太字</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Font.Bold = </span><span style="color:#569CD6">True</span></span>
<span class="line"><span style="color:#6A9955"># イタリック</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Font.Italic = </span><span style="color:#569CD6">True</span></span>
<span class="line"><span style="color:#6A9955"># 下線</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Font.Underline = </span><span style="color:#569CD6">True</span></span>
<span class="line"><span style="color:#6A9955"># 取消線</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Font.Strikethrough = </span><span style="color:#569CD6">True</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 文字色</span></span>
<span class="line"><span style="color:#D4D4D4">vbRed = </span><span style="color:#569CD6">0x</span><span style="color:#B5CEA8">FF</span></span>
<span class="line"><span style="color:#D4D4D4">ws.Range(</span><span style="color:#CE9178">'A1'</span><span style="color:#D4D4D4">).Font.Color = vbRed</span></span></code></pre></div>



<h2 class="wp-block-heading">Excel の定数をインポートする</h2>



<p class="wp-block-paragraph">Excel の定数はインポートができます。</p>



<p class="wp-block-paragraph">VBAでお馴染みのxlUp / xlDown / xlYes / xlContinuous などをそのまま使えます。</p>



<p class="is-style-icon_info wp-block-paragraph">ただし定数をPython用に変換する処理が入るので、初回実行に少し時間がかかることもあります。<br>パフォーマンス重視なら、constantsを使わないという考え方もありです。</p>



<h3 class="wp-block-heading">定数をインポートする理由</h3>



<p class="wp-block-paragraph">可読性が上がるためです。</p>



<p class="wp-block-paragraph">定数を使わない場合には、次のようなコードになります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ws.Cells(ws.Rows.Count, 1).End(-4162).Row</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">ws.Cells(ws.Rows.Count, </span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">).End(-</span><span style="color:#B5CEA8">4162</span><span style="color:#D4D4D4">).Row</span></span></code></pre></div>



<p class="wp-block-paragraph">これでは<code>-4162</code>が何を表すのかが一目でわかりません。</p>



<p class="wp-block-paragraph">一方でconstantsを使うと、次のようにわかりやすくなります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ws.Cells(ws.Rows.Count, 1).End(constants.xlUp).Row</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">ws.Cells(ws.Rows.Count, </span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">).End(constants.xlUp).Row</span></span></code></pre></div>



<h3 class="wp-block-heading">基本的な書き方</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client as win32
from win32com.client import constants

excel = win32.Dispatch("Excel.Application")
wb = excel.Workbooks.Open("sample.xlsx")
ws = wb.Worksheets(1)

# 最終行を取得（VBAと同じ書き方）
last_row = ws.Cells(ws.Rows.Count, 1).End(constants.xlUp).Row

print(last_row)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client </span><span style="color:#C586C0">as</span><span style="color:#D4D4D4"> win32</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> win32com.client </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> constants</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">excel = win32.Dispatch(</span><span style="color:#CE9178">"Excel.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">wb = excel.Workbooks.Open(</span><span style="color:#CE9178">"sample.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">ws = wb.Worksheets(</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 最終行を取得（VBAと同じ書き方）</span></span>
<span class="line"><span style="color:#D4D4D4">last_row = ws.Cells(ws.Rows.Count, </span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">).End(constants.xlUp).Row</span></span>
<span class="line"></span>
<span class="line"><span style="color:#DCDCAA">print</span><span style="color:#D4D4D4">(last_row)</span></span></code></pre></div>



<h3 class="wp-block-heading">よく使うExcelの定数一覧</h3>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>定数名</th><th>用途</th></tr></thead><tbody><tr><td><code>constants.xlUp</code></td><td>上方向に移動</td></tr><tr><td><code>constants.xlDown</code></td><td>下方向に移動</td></tr><tr><td><code>constants.xlToLeft</code></td><td>左方向</td></tr><tr><td><code>constants.xlToRight</code></td><td>右方向</td></tr><tr><td><code>constants.xlYes</code></td><td>ヘッダーあり</td></tr><tr><td><code>constants.xlNo</code></td><td>ヘッダーなし</td></tr><tr><td><code>constants.xlContinuous</code></td><td>実線の罫線</td></tr><tr><td><code>constants.xlEdgeBottom</code></td><td>下罫線</td></tr><tr><td><code>constants.xlCenter</code></td><td>中央揃え</td></tr></tbody></table></figure>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">冒頭でも説明した通り、<code>openpyxl</code>では罫線やグラフが消えてしまうので、<code>win32com</code>を使うのがおすすめです。</p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
