図面やレイアウト資料だと、目視で差分を探すのは本当に大変です。しかも、見落としが起きると確認作業をやり直す羽目になりがち。

この記事では、PythonとOpenCVを使ってPDFを画像化し、線・図形・枠線などの“構造的な差分”を検出して緑色でハイライト表示する方法を解説します。

クリック操作で使えるGUI付きなので、コードに慣れていない人でも扱いやすいのがポイントです。

ただし、この方法は文字の微妙なズレ・フォント変更などの差分には弱い面もあります。
そのため「何に強くて、何に弱いのか」も含めて、実用目線でまとめました。

pip install pdf2image pillow opencv-python numpy

import os
import cv2
import numpy as np
from tkinter import Tk, filedialog, Button, Label, Frame
from PIL import ImageTk, Image
from pdf2image import convert_from_path

# =========================
# 設定（ここを環境に合わせて変更）
# =========================
POPPLER_PATH = r"C:\poppler-xx.xx.x\Library\bin" # ←実際のパスに変更

# 差分検出の感度（まず触るのはここ）
CANNY_LOW = 50
CANNY_HIGH = 150
DIFF_THRESHOLD = 30 # 大きいほど鈍感（差分が減る）
MIN_CONTOUR_AREA = 80 # 小さい差分（ゴミ）を無視する面積しきい値

# プレビュー表示サイズ（GUI上）
PREVIEW_W, PREVIEW_H = 760, 520

# =========================
# GUI
# =========================
root = Tk()
root.title("PDF差分ハイライトツール（線・図形向け）")
root.geometry("900x720")

status = Label(root, text="変更前PDFと変更後PDFを選択してください", anchor="w", justify="left")
status.pack(fill="x", padx=10, pady=10)

pdf_old_path = ""
pdf_new_path = ""
result_img_full = None # 保存用（フル解像度）

image_label = Label(root)
image_label.pack(padx=10, pady=10)

btn_frame = Frame(root)
btn_frame.pack(pady=10)

def set_status(msg: str):
status.config(text=msg)

def select_old_pdf():
global pdf_old_path
path = filedialog.askopenfilename(filetypes=[("PDF files", "*.pdf")])
if path:
pdf_old_path = path
set_status(f"変更前PDF: {os.path.basename(pdf_old_path)}\n変更後PDF: {os.path.basename(pdf_new_path) if pdf_new_path else '未選択'}")

def select_new_pdf():
global pdf_new_path
path = filedialog.askopenfilename(filetypes=[("PDF files", "*.pdf")])
if path:
pdf_new_path = path
set_status(f"変更前PDF: {os.path.basename(pdf_old_path) if pdf_old_path else '未選択'}\n変更後PDF: {os.path.basename(pdf_new_path)}")

def render_first_page(pdf_path: str):
images = convert_from_path(
pdf_path,
poppler_path=POPPLER_PATH,
first_page=1,
last_page=1
)
return np.array(images[0]) # RGB

def highlight_diff(img_old_rgb: np.ndarray, img_new_rgb: np.ndarray):
# グレースケール
old_gray = cv2.cvtColor(img_old_rgb, cv2.COLOR_RGB2GRAY)
new_gray = cv2.cvtColor(img_new_rgb, cv2.COLOR_RGB2GRAY)

# エッジ抽出
old_edges = cv2.Canny(old_gray, CANNY_LOW, CANNY_HIGH)
new_edges = cv2.Canny(new_gray, CANNY_LOW, CANNY_HIGH)

# 差分
diff_edges = cv2.absdiff(old_edges, new_edges)

# 2値化（差分マスク）
mask = cv2.threshold(diff_edges, DIFF_THRESHOLD, 255, cv2.THRESH_BINARY)[1]

# 見やすくするため少し膨張
kernel = np.ones((3, 3), np.uint8)
mask = cv2.dilate(mask, kernel, iterations=1)

# 小さい差分を除外（ノイズ対策）
contours, _ = cv2.findContours(mask, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
cleaned = np.zeros_like(mask)
for c in contours:
if cv2.contourArea(c) >= MIN_CONTOUR_AREA:
cv2.drawContours(cleaned, [c], -1, 255, thickness=cv2.FILLED)

# ハイライト（緑）
base = cv2.cvtColor(old_gray, cv2.COLOR_GRAY2BGR)
base[cleaned > 0] = [0, 255, 0]
return base

def compare_pdfs():
global result_img_full

if not pdf_old_path or not pdf_new_path:
set_status(" 変更前・変更後のPDFを両方選択してください")
return

try:
old_rgb = render_first_page(pdf_old_path)
new_rgb = render_first_page(pdf_new_path)
except Exception as e:
set_status(
" PDFの画像化に失敗しました。\n"
"Popplerのパスが正しいか、pdfinfoが動くか確認してください。\n\n"
f"エラー: {e}"
)
return

# サイズ違い対策
if old_rgb.shape != new_rgb.shape:
set_status(
" 2つのPDFで画像サイズが異なります。\n"
"簡易的に『変更後』を『変更前』に合わせてリサイズして比較します（精度は落ちます）。"
)
new_rgb = cv2.resize(new_rgb, (old_rgb.shape[1], old_rgb.shape[0]))

result_img_full = highlight_diff(old_rgb, new_rgb)

# プレビュー用に縮小
preview = cv2.resize(result_img_full, (PREVIEW_W, PREVIEW_H))
preview_rgb = cv2.cvtColor(preview, cv2.COLOR_BGR2RGB)
tk_img = ImageTk.PhotoImage(Image.fromarray(preview_rgb))

image_label.config(image=tk_img)
image_label.image = tk_img

set_status(
" 変更された線・図形を緑でハイライトしました（1ページ目）。\n"
"差分が多すぎる場合は DIFF_THRESHOLD / MIN_CONTOUR_AREA を調整してください。"
)

def save_image():
global result_img_full
if result_img_full is None:
set_status(" 画像がまだ生成されていません（先に『差分を比較』を実行してください）")
return

save_path = filedialog.asksaveasfilename(
defaultextension=".png",
filetypes=[("PNG files", "*.png")]
)
if save_path:
cv2.imwrite(save_path, result_img_full)
set_status(f" 画像を保存しました: {os.path.basename(save_path)}")

Button(btn_frame, text="変更前PDFを選択", command=select_old_pdf, width=20).grid(row=0, column=0, padx=6, pady=6)
Button(btn_frame, text="変更後PDFを選択", command=select_new_pdf, width=20).grid(row=0, column=1, padx=6, pady=6)
Button(btn_frame, text="差分を比較（1ページ目）", command=compare_pdfs, width=22).grid(row=0, column=2, padx=6, pady=6)
Button(btn_frame, text="画像を保存（PNG）", command=save_image, width=18).grid(row=0, column=3, padx=6, pady=6)

root.mainloop()

GUIイメージ

GUI内の余白はハイライト確認用です。

サンプルイメージを実行してみる

上記サンプル画像を比較ツールにかけてどんな結果が得られるか実験してみました。

結果が下図。

違いは△の有無でしたが、ちゃんと黄緑ハイライトされているのが分かります。抽出できているようです。

次に、実務で使えるレベルなのか、私が普段使っている”図面”で試してみます。

結果が下図。

完全一致している”はず”の部分もハイライトされてしまって分かりづらいですね。PDF同士の比較をする際に微小なズレが生じているせいですかね。

ただ、ズレている部分もちゃんと分かるので、ざっくり知りたい初期比較ツールとしては使えそうです。

差分が「緑まみれ」になるときの調整方法

この手法で一番多い悩みが「ページ全体が緑になる」問題です。
だいたいは差分感度が高すぎるか、微小なノイズが拾われすぎています。

• 差分が多すぎる：
  DIFF_THRESHOLD を上げる（例：30 → 45 / 60）
• ゴミっぽい点が多い：
  MIN_CONTOUR_AREA を上げる（例：80 → 150 / 300）
• 逆に差分が出ない：
  DIFF_THRESHOLD を下げる（例：30 → 15）、
  もしくはCannyの閾値（CANNY_LOW/HIGH）を調整

まずは DIFF_THRESHOLD と MIN_CONTOUR_AREA の2つを触るのが最短です。

そんなときに使えるのが、今回紹介する「一括置換GUI（Python）」です。

このスクリプトは、.bat/.cmd/.txt/.docx/.xlsx のように拡張子が混在していても、同じ文字列を一括で置換できます。さらにGUI付きでドライラン（プレビュー）で事前に変更点を確認でき、バックアップも自動で作れるため、作業ミスを減らしやすい設計です。

この記事でできること（要点）

注意（先に読んでおくと安心）

動作環境・必要なもの

インストール（Word/Excel対応を使う場合）

pip install python-docx openpyxl

※未インストールでもスクリプト自体は動きます。該当拡張子はログに [SKIP] と出して処理をスキップします。

使い方（GUIの手順）

1) スクリプトを起動する

例：batch_replace_gui.py として保存し、次で実行します。

python batch_replace_gui.py

2) 旧文字列 / 新文字列を入力

GUI上部で、置換したい「旧文字列」と「新文字列」を入力します。デフォルト値はコード側（OLD / NEW）で変更できます。

3) 置換対象の「フォルダ」を選択

ファイルではなくフォルダを選ぶ点に注意してください。フォルダ配下を再帰的に走査して置換します。

4) 最初は「ドライラン（プレビュー）」を押す（推奨）

ドライランではファイルは変更されません。ログに「どのファイルのどの部分が置換対象か」が表示されます。

たとえば、置換対象フォルダの状態が以下のように「旧文字列」を含んでいる想定です。

5) 問題なければ「置換を実行」

置換を実行すると、バックアップがONの場合はまずバックアップを作成し、その後に置換処理を行います。

完了後、バックアップフォルダと置換済みファイルが残ります。

バックアップが不要なら、GUIの「置換前にバックアップを作成」のチェックを外してください（ただし最初の運用はON推奨）。

仕様のポイント（事故りにくくする設計）

大文字/小文字を無視して置換

re.IGNORECASE を使い、旧文字列の大文字/小文字違いを吸収します。

バックスラッシュを含む置換でも事故りにくい

re.sub は置換文字列に \ が含まれると解釈が絡んで事故ることがあります。本スクリプトは「関数置換」を使い、エスケープ問題を避けやすくしています。

バックアップフォルダを自動除外

バックアップは _backup_YYYYMMDD_HHMMSS 形式で作成し、その配下は走査対象から除外します（バックアップをバックアップして無限増殖しないため）。

注意点（ここだけは押さえる）

テキスト系（.bat/.cmd/.txt）の文字コード

• 読み取りは「UTF-8(BOM) / UTF-16(BOM) / UTF-8 / cp932」などを順に試すスマート判定です
• 書き込みはGUIで ANSI（cp932） or UTF-8（BOMなし） を選択します
• 古い環境のバッチはUTF-8で動かないことがあるので、迷ったらANSIのままが無難です

Word（.docx）は装飾が崩れる可能性あり

置換は段落単位（paragraph.text）で行うため、段落内の装飾（太字、色、リンクなど）が置換後に失われることがあります。

• 見た目が重要な文書は、必ずドライラン＋バックアップ＋少量でテストしてください
• 装飾を保持したい場合は「run単位での置換」実装が必要になります

Excel（.xlsx）は文字列セルが対象（数式は既定でスキップ）

既定では数式セルはスキップします。数式内文字列まで置換したい場合は、コードの引数（include_formula）側を拡張してください。

置換対象は「テキストとしての一致」

旧文字列はそのまま文字として扱い、正規表現の特殊記号はエスケープしています。つまり「部分一致の単純置換」です。正規表現置換をしたい場合は設計変更が必要です。

スクリプト全文（コピペ用）

以下が本体コードです（そのまま動く形に整形済み）。

# -*- coding: utf-8 -*-
"""
フォルダ内ファイル一括置換（GUI）
対応: .bat/.cmd, .txt, .docx, .xlsx
機能:
- GUIでフォルダ選択
- ドライラン（プレビュー）
- バックアップ（フォルダ丸コピー）
- 文字コード: ANSI(cp932) / UTF-8(BOMなし)（テキスト系のみ）
- 大文字小文字無視
"""

import os
import shutil
import re
import tkinter as tk
from tkinter import filedialog, messagebox
from datetime import datetime

# 追加ライブラリ（Word/Excel）
try:
    from docx import Document
    DOCX_AVAILABLE = True
except Exception:
    DOCX_AVAILABLE = False

try:
    from openpyxl import load_workbook
    XLSX_AVAILABLE = True
except Exception:
    XLSX_AVAILABLE = False

# デフォルト文字列（GUI上で変更可能）
OLD = "てんぷれ"
NEW = "スーパーテンプレート"


def is_under_backup(path, root):
    """ルート直下の _backup_YYYYMMDD_HHMMSS 配下を除外"""
    rel = os.path.relpath(path, root)
    top = rel.split(os.sep, 1)[0].lower()
    return top.startswith("_backup_")


def read_text_smart(file_path):
    """
    テキスト読み取り（スマート版）
    優先度: UTF-8(BOM) / UTF-16(BOM) -> UTF-8(no BOM) -> cp932 -> latin-1
    戻り値: (text, detected_encoding)
    """
    with open(file_path, "rb") as f:
        data = f.read()

    # UTF-8 BOM
    if len(data) >= 3 and data[0:3] == b"\xef\xbb\xbf":
        try:
            return data[3:].decode("utf-8", errors="strict"), "utf8-bom"
        except Exception:
            return data[3:].decode("utf-8", errors="replace"), "utf8-bom(replace)"

    # UTF-16 BOM (LE/BE)
    if len(data) >= 2 and (data[0:2] == b"\xff\xfe" or data[0:2] == b"\xfe\xff"):
        try:
            return data.decode("utf-16", errors="strict"), "utf16-bom"
        except Exception:
            return data.decode("utf-16", errors="replace"), "utf16-bom(replace)"

    # UTF-8（BOMなし）
    try:
        return data.decode("utf-8", errors="strict"), "utf8"
    except Exception:
        pass

    # cp932（Shift-JIS相当）
    try:
        return data.decode("cp932", errors="strict"), "cp932"
    except Exception:
        # 最終保険（絶対に失敗しないが文字化けの可能性あり）
        return data.decode("latin-1"), "latin-1"


def write_text(file_path, text, use_utf8):
    """テキスト書き込み"""
    if use_utf8:
        with open(file_path, "wb") as f:
            f.write(text.encode("utf-8"))  # BOMなしUTF-8
    else:
        with open(file_path, "wb") as f:
            f.write(text.encode("cp932", errors="replace"))


def copy_tree(src, dst):
    """フォルダ丸ごとコピー（バックアップ用）"""
    if not os.path.exists(dst):
        os.makedirs(dst)

    for root, dirs, files in os.walk(src):
        rel = os.path.relpath(root, src)
        target_dir = os.path.join(dst, rel) if rel != "." else dst
        if not os.path.exists(target_dir):
            os.makedirs(target_dir)

        for name in files:
            src_file = os.path.join(root, name)
            dst_file = os.path.join(target_dir, name)
            try:
                shutil.copy2(src_file, dst_file)
            except Exception as e:
                print(f"[BACKUP-ERROR] {src_file} -> {e}")


# ---------- ファイルタイプ別の処理 ----------

def process_text_file(file, pattern, new, dry_run, use_utf8, append_log):
    """BAT/TXTのテキスト置換"""
    text, enc = read_text_smart(file)
    if not pattern.search(text):
        return False

    if dry_run:
        append_log(f"[DRY] {file} (enc={enc})")
        shown = 0
        for line in text.splitlines():
            if pattern.search(line):
                append_log(" - " + line)
                append_log(" + " + pattern.sub(lambda m: new, line))
                shown += 1
                if shown >= 5:
                    break
        return True

    new_text = pattern.sub(lambda m: new, text)
    write_text(file, new_text, use_utf8)
    append_log(f"[CHANGED] {file} (enc={enc} -> {'utf8' if use_utf8 else 'cp932'})")
    return True


def process_docx_file(file, pattern, new, dry_run, append_log):
    """
    Word(.docx)の置換：段落、表、ヘッダ/フッタを対象。
    注意: 段落単位で置換するため装飾が失われる可能性あり
    """
    if not DOCX_AVAILABLE:
        append_log(f"[SKIP] {file} -> python-docx 未導入")
        return False

    try:
        doc = Document(file)
    except Exception as e:
        append_log(f"[ERROR-OPEN-DOCX] {file} -> {e}")
        return False

    changed = False
    preview_shown = 0

    def clip(s, n=120):
        return s if len(s) <= n else s[:n] + "..."

    def replace_in_paragraphs(paragraphs):
        nonlocal changed, preview_shown
        for p in paragraphs:
            txt = p.text
            if not txt:
                continue
            if pattern.search(txt):
                if dry_run:
                    if preview_shown < 5: before = txt after = pattern.sub(lambda m: new, txt) append_log(" - " + clip(before)) append_log(" + " + clip(after)) preview_shown += 1 changed = True else: p.text = pattern.sub(lambda m: new, txt) changed = True # 本文 replace_in_paragraphs(doc.paragraphs) # 表（セル内段落） for table in doc.tables: for row in table.rows: for cell in row.cells: replace_in_paragraphs(cell.paragraphs) # ヘッダー/フッター for section in doc.sections: replace_in_paragraphs(section.header.paragraphs) replace_in_paragraphs(section.footer.paragraphs) if changed and not dry_run: try: doc.save(file) append_log(f"[CHANGED] {file}") except Exception as e: append_log(f"[ERROR-SAVE-DOCX] {file} -> {e}")
            return False
    elif changed and dry_run:
        append_log(f"[DRY] {file}")

    return changed


def process_xlsx_file(file, pattern, new, dry_run, append_log, include_formula=False):
    """
    Excel(.xlsx)の置換：全シートの文字列セル
    既定では数式セルはスキップ（include_formula=False）
    """
    if not XLSX_AVAILABLE:
        append_log(f"[SKIP] {file} -> openpyxl 未導入")
        return False

    try:
        wb = load_workbook(file, data_only=False)  # 数式保持
    except Exception as e:
        append_log(f"[ERROR-OPEN-XLSX] {file} -> {e}")
        return False

    changed = False
    preview_count = 0

    def clip(s, n=80):
        return s if len(s) <= n else s[:n] + "..."

    for ws in wb.worksheets:
        for row in ws.iter_rows(values_only=False):
            for cell in row:
                try:
                    val = cell.value

                    # 数式セルの扱い
                    if getattr(cell, "data_type", None) == "f" and not include_formula:
                        continue

                    if isinstance(val, str) and pattern.search(val):
                        if dry_run:
                            if preview_count < 10: before = val after = pattern.sub(lambda m: new, val) addr = f"{ws.title}!{cell.coordinate}" append_log(f" - {addr}: {clip(before)}") append_log(f" + {addr}: {clip(after)}") preview_count += 1 changed = True else: cell.value = pattern.sub(lambda m: new, val) changed = True except Exception as e: append_log(f"[ERROR-CELL] {file} {ws.title}!{cell.coordinate} -> {e}")

    if changed and not dry_run:
        try:
            wb.save(file)
            append_log(f"[CHANGED] {file}")
        except Exception as e:
            append_log(f"[ERROR-SAVE-XLSX] {file} -> {e}")
            return False
    elif changed and dry_run:
        append_log(f"[DRY] {file}")

    return changed


# ---------- GUI 本体 ----------

class App(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("一括置換 - Python版（拡張）")
        self.geometry("900x640")
        self.resizable(False, False)

        tk.Label(self, text="旧文字列:").place(x=10, y=15)
        self.old_var = tk.StringVar(value=OLD)
        tk.Entry(self, textvariable=self.old_var, width=80).place(x=80, y=12)

        tk.Label(self, text="新文字列:").place(x=10, y=45)
        self.new_var = tk.StringVar(value=NEW)
        tk.Entry(self, textvariable=self.new_var, width=80).place(x=80, y=42)

        tk.Label(self, text="対象フォルダ:").place(x=10, y=75)
        self.folder_var = tk.StringVar()
        tk.Entry(self, textvariable=self.folder_var, width=80).place(x=80, y=72)
        tk.Button(self, text="参照...", command=self.browse).place(x=790, y=68, width=90)

        # オプション
        self.backup_var = tk.BooleanVar(value=True)
        tk.Checkbutton(self, text="置換前にバックアップを作成", variable=self.backup_var).place(x=80, y=100)

        self.utf8_var = tk.BooleanVar(value=False)
        tk.Checkbutton(self, text="テキスト書き込みをUTF-8（BOMなし）にする（既定はANSI）", variable=self.utf8_var).place(x=320, y=100)

        # 対象拡張子
        tk.Label(self, text="対象拡張子:").place(x=10, y=130)
        self.use_bat_var = tk.BooleanVar(value=True)
        self.use_txt_var = tk.BooleanVar(value=True)
        self.use_docx_var = tk.BooleanVar(value=True)
        self.use_xlsx_var = tk.BooleanVar(value=True)

        tk.Checkbutton(self, text=".bat/.cmd", variable=self.use_bat_var).place(x=80, y=128)
        tk.Checkbutton(self, text=".txt", variable=self.use_txt_var).place(x=180, y=128)
        tk.Checkbutton(self, text=".docx", variable=self.use_docx_var).place(x=240, y=128)
        tk.Checkbutton(self, text=".xlsx", variable=self.use_xlsx_var).place(x=310, y=128)

        tk.Button(self, text="ドライラン（プレビュー）", command=lambda: self.execute(False)).place(x=80, y=160, width=180)
        tk.Button(self, text="置換を実行", command=lambda: self.execute(True)).place(x=270, y=160, width=120)

        self.log = tk.Text(self, width=110, height=26)
        self.log.place(x=10, y=200)

        self.status = tk.Label(self, text="準備完了", anchor="w")
        self.status.place(x=10, y=600, width=880)

    def browse(self):
        d = filedialog.askdirectory(title="対象フォルダを選択")
        if d:
            self.folder_var.set(d)

    def append_log(self, text):
        self.log.insert(tk.END, text + "\n")
        self.log.see(tk.END)

    def execute(self, replace):
        self.log.delete("1.0", tk.END)
        self.status.config(text=("置換を実行中..." if replace else "ドライランを実行中..."))

        root = self.folder_var.get().strip()
        old = self.old_var.get()
        new = self.new_var.get()
        use_utf8 = self.utf8_var.get()

        if not root or not os.path.isdir(root):
            messagebox.showerror("エラー", "対象フォルダが不正です。")
            self.status.config(text="フォルダ不正")
            return

        if not old or not new:
            messagebox.showerror("エラー", "旧文字列と新文字列を入力してください。")
            self.status.config(text="文字列未入力")
            return

        # 大文字小文字無視で検索（old内の記号もそのまま扱う）
        pattern = re.compile(re.escape(old), re.IGNORECASE)

        backup_path = None
        if replace and self.backup_var.get():
            backup_path = os.path.join(root, "_backup_" + datetime.now().strftime("%Y%m%d_%H%M%S"))
            try:
                self.append_log(f"バックアップ作成中: {backup_path}")
                copy_tree(root, backup_path)
                self.append_log("バックアップ作成完了。")
            except Exception as e:
                self.append_log(f"[バックアップ失敗] {e}")
                if not messagebox.askyesno("警告", "バックアップに失敗しました。続行しますか？"):
                    self.status.config(text="バックアップ失敗")
                    return

        # 対象ファイル収集
        targets = []
        use_bat = self.use_bat_var.get()
        use_txt = self.use_txt_var.get()
        use_docx = self.use_docx_var.get()
        use_xlsx = self.use_xlsx_var.get()

        for dirpath, _, filenames in os.walk(root):
            for fname in filenames:
                lower = fname.lower()
                ext = os.path.splitext(lower)[1]

                cond = False
                if use_bat and ext in (".bat", ".cmd"):
                    cond = True
                elif use_txt and ext in (".txt",):
                    cond = True
                elif use_docx and ext in (".docx",):
                    cond = True
                elif use_xlsx and ext in (".xlsx",):
                    cond = True

                if cond:
                    full = os.path.join(dirpath, fname)
                    if not is_under_backup(full, root):
                        targets.append(full)

        if not targets:
            self.append_log("対象ファイルが見つかりません。")
            self.status.config(text="対象なし")
            return

        changed = 0
        for file in targets:
            try:
                ext = os.path.splitext(file.lower())[1]
                if ext in (".bat", ".cmd", ".txt"):
                    ch = process_text_file(file, pattern, new, not replace, use_utf8, self.append_log)
                elif ext == ".docx":
                    ch = process_docx_file(file, pattern, new, not replace, self.append_log)
                elif ext == ".xlsx":
                    ch = process_xlsx_file(file, pattern, new, not replace, self.append_log, include_formula=False)
                else:
                    ch = False

                if ch:
                    changed += 1
            except Exception as e:
                self.append_log(f"[ERROR] {file} -> {e}")

        if replace:
            self.append_log(f"=== 置換完了：{changed} 件変更 ===")
            if backup_path:
                self.append_log(f"バックアップ: {backup_path}")
            self.status.config(text=f"置換完了（{changed}件）")
        else:
            self.append_log("=== ドライラン完了。問題なければ『置換を実行』を押してください。===")
            self.status.config(text="ドライラン完了")


if __name__ == "__main__":
    # 高DPIでの表示崩れ対策（失敗してもOK）
    try:
        from ctypes import windll
        windll.shcore.SetProcessDpiAwareness(1)
    except Exception:
        pass

    app = App()
    app.mainloop()

拡張したいとき（.ini / .csv を追加する例）

テキストとして扱える拡張子なら、対象拡張子の判定に追加するだけで対応できます。たとえば .ini と .csv を追加する場合は、拡張子チェックの部分に次を足します。

# 例：.ini / .csv をテキスト扱いで追加する
elif use_txt and ext in (".txt", ".ini", ".csv"):
    cond = True

※ただしCSVは文字コード・改行コードが混在しやすいので、最初は必ずドライランで確認してください。

FAQ（よくある疑問）

Q. バックアップが大きくなります

フォルダ丸ごとコピーなので、対象フォルダが大きいとバックアップも大きくなります。まずは対象を必要最小限のフォルダに絞るのが現実的です。

Q. Wordの見た目が崩れた

段落単位で置換する仕様上、装飾が消えるケースがあります。見た目が重要なdocxは、対象を限定して試すか、run単位の置換が必要です。

Q. Excelの数式の中も置換したい

既定では数式セルはスキップです。数式まで置換する場合は、include_formula=True の設計に合わせて拡張してください（数式破壊のリスクが上がるため、慎重に）。

免責事項

本記事のスクリプトは、ファイル内容を一括で変更する性質上、適用範囲が広くなります。必ずドライランで確認し、バックアップを取ったうえで自己責任で実行してください。業務データに適用する場合は、所属組織のルール（権限・監査・バックアップ手順）に従ってください。

文字起こしして、要点を拾って、体裁を整えて、最後に「偉い人に怒られない文章」に調整して……。

そこで今回は、「録音（mp3/m4a等） → Wordのトランスクリプトで文字起こし → Copilotで議事録化」という流れで、音声ファイルさえあれば”最短5分”で議事録のたたき台を作る方法をまとめます。

この記事でわかること

対象読者

事前準備：必要なもの（ここだけ確認）

Wordのトランスクリプトで使える音声ファイル形式

「mp3は使える？」「m4aは対応してる？」という疑問が多いので、先に対応形式をまとめます。

ファイル形式	対応	備考
.mp3	対応	最も一般的。ボイスレコーダーアプリで多い
.m4a	対応	iPhoneのボイスメモ、Windowsサウンドレコーダーの標準形式
.wav	対応	高品質だがファイルサイズが大きい
.mp4	対応	動画ファイルの音声部分を文字起こし可能
.webm	対応	ブラウザ録画などで使われる形式

※ファイルサイズの上限は約200MB（最大約4時間）です。長時間の会議はファイルサイズに注意してください。

iPhoneで録ったボイスメモ（m4a）もそのまま使えます。スマホで録音 → PCに転送 → Wordにアップロード、という流れが手軽です。

手順1：サウンドレコーダーで会議を録音する（Windows 11）

まずはWindows標準のサウンドレコーダーで録音します。

保存先は、基本的にドキュメント → サウンドレコーディングフォルダです（環境によりOneDrive配下の場合もあります）。

保存される形式は「.m4a」です。この形式はWordのトランスクリプトにそのまま使えるので、変換の手間はありません。

手順2：Wordのトランスクリプトで音声ファイルを文字起こしする

次にWordで文字起こしします。メニューは以下。

Word → ホーム → ディクテーション → トランスクリプト

音声ファイル（mp3/m4a/wav等）をアップロードすると文字起こしが始まります。

文字起こし中。ファイルサイズや長さによりますが、数分〜10分程度で完了します。

文字起こし完了。

「ドキュメントに追加」を押すと、出力形式を選べます。

今回は「話者とタイムスタンプ」を選択。本文に会話がまとまって出てきます。

Wordの文字起こし精度について（読まなくてOK）

正直、録音環境によっては文字起こし精度が荒れて、下図のように意味不明な文字列が並ぶこともあります。

でも、ここで頑張って1文ずつ解読しないでください。

勝ち筋は「要点抽出」です。荒れたトランスクリプトでも、AIは文脈から重要なポイントを拾って議事録に整形できます。

手順3：Copilotで音声の文字起こしを議事録にまとめる（プロンプト例つき）

Wordのトランスクリプト（全文）をCopilot（またはChatGPT/GeminiでもOK）にコピペして、次のように指示します。

最短で効く指示（基本形）

「下記の内容の要点を抽出して議事録としてまとめて」

出力例（※一部伏せ）。

実際にやってもらうとわかりますが「あの意味不明テキストから、ここまで整った議事録になるの！？」ってなるはずです。

もっと精度が上がる指示（テンプレ）

可能なら、開催情報・参加者・目的を一緒に入れてください。AIの”まとめ方”が安定します。

あなたは議事録作成のプロです。
以下のトランスクリプトを、社内共有できる「議事録」に整形してください。

【会議情報】
– 会議名：
– 開催日時：
– 参加者：
– 目的：

【出力形式】
1. サマリー（3行）
2. 議題ごとの要点（箇条書き）
3. 決定事項（Decision）
4. アクションアイテム（担当者/期限/内容）
5. 未決事項・リスク
6. 次回までの宿題

【注意】
– 曖昧な発言は断定せず「不明」「要確認」と明記
– 固有名詞/数値は可能な範囲で保持
– 長文は短く、読みやすく

【トランスクリプト】
（ここに貼り付け）

Teams会議のトランスクリプトを使えば、さらに議事録精度が上がる

今回の流れは”録音ファイル”ベースでしたが、Teamsの会議録画・トランスクリプトでも同じことができます。

• Teams側のトランスクリプトは、環境によっては発言者・タイムライン情報が整いやすい
• 会議の「Recap」などからトランスクリプトを取り出せる場合がある
• M365 Copilotが有効な環境なら、Teams上で直接「会議のまとめ」を生成できるケースもある

Teamsのトランスクリプトを取得できる環境なら、「Teamsトランスクリプト → Copilotで議事録化」が最短ルートです。

うまくいかない時のチェックリスト（よくある詰まり）

• Wordにトランスクリプトが出ない：Microsoft 365へのサインイン状況、Wordのバージョン、ブラウザ要件（Web版利用時）を確認
• mp3やm4aをアップロードできない：ファイルサイズ（200MB上限）を確認。長時間録音は分割してアップロード
• 文字起こしが崩壊する：録音環境（反響・ノイズ）を改善。可能ならマイク位置を工夫
• 議事録が薄い/ズレる：会議情報（目的・議題・参加者）を先に与える／出力形式を指定する
• 機密が怖い：固有名詞・顧客名・金額などはマスクしてから投入（例：A社、Bさん、金額X）

セキュリティ・コンプライアンスの注意（重要）

この手法は強力ですが、音声やトランスクリプトには個人情報・機密情報が含まれがちです。

よくある質問（FAQ）

Q. mp3ファイルはWordのトランスクリプトで使える？

使えます。mp3はWordのトランスクリプトで最もよく使われる形式の一つです。ボイスレコーダーアプリで録ったmp3ファイルをそのままアップロードすればOKです。

Q. iPhoneのボイスメモ（m4a）もそのまま使える？

使えます。iPhoneのボイスメモは.m4a形式で保存されますが、Wordのトランスクリプトはm4aに対応しています。AirDropやメール等でPCに転送してアップロードしてください。

Q. mp4（動画ファイル）でも文字起こしできる？

できます。mp4の場合は動画の音声部分が自動的に抽出されて文字起こしされます。Teams会議の録画ファイルなども同じ要領で使えます。

Q. Copilotの無料版でも議事録は作れる？

Copilot Chat（無料で使えるブラウザ版）でも基本的な議事録作成は可能です。ただし、一度に貼り付けられるテキスト量に制限がある場合があります。長い会議のトランスクリプトは、議題ごとに分割して投入するのが安全です。ChatGPTやGeminiでも同様のことができます。

Q. Windowsのサウンドレコーダーで録音したファイルはそのまま使える？

そのまま使えます。Windows 11のサウンドレコーダーは.m4a形式で保存されるため、Wordのトランスクリプトに直接アップロードできます。変換は不要です。

まとめ：議事録は「全文理解」ではなく「要点化」で最速になる

議事録作成のボトルネックは、文字起こしを読んで要点を抽出する作業です。

でも、今回のように

• 録音（サウンドレコーダーやスマホで.mp3/.m4aを取得）
• Wordのトランスクリプトで音声ファイルを文字起こし
• Copilotで要点整理して議事録化

という流れにすると、「議事録のたたき台」はすぐ作れます。

あとは最後に、人間が固有名詞・数字・ニュアンスだけ軽くチェックすればOK。会議が多い人ほど、体感で効いてきます。

ぜひ一度試してみてください！

Copilot以外のAIツールも含めて活用法を知りたい方は、こちらも参考になります↓

• AI学習におすすめの教材・ツールまとめ
• ChatGPT初心者向けプロンプト＆ツール集

もっと業務を自動化したい方へ

議事録以外にも、PDF・Excel・ファイル整理など、Pythonで自動化できる業務は意外と多いです。製造業・事務職の現場で使える自動化レシピをまとめています。

→ AI×Pythonで業務を自動化する方法まとめ

免責事項（AI活用の前提）

本記事の手順は、筆者の環境での検証をもとに紹介しています。機能の提供状況や利用条件（ライセンス/組織ポリシー）は環境により異なります。Wordのトランスクリプトが対応するファイル形式・サイズ上限は変更される可能性があるため、最新情報はMicrosoft公式ドキュメントも確認してください。AIの出力は誤りを含む可能性があるため、社内外に共有する前に必ず人間が確認してください。

これ、初心者あるあるです。

原因は「Jupyterが悪い」よりも、Python環境（conda）とJupyterの紐付けがズレているケースがほとんど。

この記事では、miniconda環境で詰まりやすい原因をTOP7に絞って、最短で直すチェックリストとしてまとめます（Windows/Mac対応）。

結論：まずは「どのPythonでJupyterが動いてるか」を揃える

Jupyterが動かない問題の多くは、

• Notebookは起動してるけど、Kernelが別のPythonを見ている
• con​​da環境に入れたはずのライブラリが、Notebookからは見えていない

このズレが原因です。なので、最初にやるべきは「Jupyterを正しいconda環境で起動する」こと。

チェック0：今いる環境を確認（ここがズレてると全部ズレる）

ターミナル（WindowsはAnaconda Prompt推奨）で、次を確認します。

# condaが見えるか
conda -V

# 環境一覧
conda env list

# 使いたい環境に入る
conda activate YOUR_ENV_NAME

# その環境のpythonを確認
python -V
where python   # Windows
which python   # Mac/Linux

原因TOP7｜miniconda×Jupyterが動かない定番パターン

原因1：Jupyterを「base」で入れて、別環境から起動している

baseにjupyterを入れて、作業環境は別（your_env）という状態だとズレやすいです。

conda activate YOUR_ENV_NAME
conda install -y jupyter

原因2：ipykernelが入っていない（または別環境のkernelを見ている）

Notebookが起動してもKernelが落ちる/ライブラリがimportできない原因の王道。

conda activate YOUR_ENV_NAME
conda install -y ipykernel
python -m ipykernel install --user --name YOUR_ENV_NAME --display-name "Python (YOUR_ENV_NAME)"

Notebook上でKernelを選ぶ：Kernel → Change Kernel → Python (YOUR_ENV_NAME)

原因3：pipで入れて、conda側の依存関係が壊れている

pip自体が悪いわけではないですが、conda環境で無計画にpipすると依存が崩れて「起動しない」につながることがあります。

原因4：Notebookがブラウザで真っ白（キャッシュ/拡張機能/HTTP周り）

原因5：ポートが埋まっている（8888が使われてる）

jupyter notebook --port=8890

原因6：PATHが汚れていて、別のPython/Jupyterを呼んでいる

VSCodeや別Pythonを入れていると起きがち。

原因7：環境が壊れている（最短は作り直し）

詰まり続けるとき、最速は環境を作り直すことが多いです（特に初心者）。

# 新規環境を作る例
conda create -n clean_env python=3.11 -y
conda activate clean_env
conda install -y jupyter ipykernel
python -m ipykernel install --user --name clean_env --display-name "Python (clean_env)"
jupyter notebook

30分で切り分ける：復旧チェックリスト（ここだけやればOK）

それでも直らない人へ：最短で解決する方法

ここまでやっても直らない場合、原因はだいたい次のどれかです。

よくある質問

Q. baseに戻すべき？

A. 基本は「作業環境（YOUR_ENV）で完結」がおすすめです。baseは最小にして、作業は分離した方が事故りません。

Q. Pythonのバージョンは？

A. 迷ったら3.10〜3.11が無難です。使いたいライブラリが対応しているバージョンを優先してください。

Q. NotebookじゃなくてJupyterLabは？

A. 同じ考え方で直せます。慣れてきたらLabの方が快適です。

以上です。まずは「正しいconda環境でJupyterを動かす」だけに集中して、ズレを潰しましょう。

初心者でも実装できる構成で、アルゴリズムの「仕組み」と「動き」を同時に学べます。

ぜひご自身の環境で作成して動かしてみてください！

使用技術

• Python
• matplotlib（アニメーション表示と画像保存）
• numpy（迷路データの管理）
• BFSアルゴリズム（最短経路探索）

表示の構成

実際につまづいたポイントと解決方法

実装時に遭遇した不具合と解決策を共有します。これから取り組む方が同じところでハマらないように参考にしてください。

最初に赤い点が表示されなかったときは「コードは動いているのになぜ？」と悩みました。試行錯誤して原因を突き止めた瞬間、アルゴリズムと可視化の関係が理解でき、プログラミングの面白さを再認識しました。

アニメーションGIF

以下が実際に生成されたアニメーションGIFです。探索者が白い通路を通ってゴールまで進む様子が赤い点で表示されます。

実際の出力結果

以下は最終的に生成された迷路画像です。赤い点がスタートからゴールまでの最短ルートを示しています。

実行方法

pip install matplotlib numpy pillow

Pythonスクリプト（最終版）

import matplotlib.pyplot as plt
import matplotlib.animation as animation
import numpy as np
import random
from collections import deque

WIDTH, HEIGHT = 21, 21
DIRS = [(-2, 0), (2, 0), (0, -2), (0, 2)]
maze = np.zeros((HEIGHT, WIDTH), dtype=int)

def generate_maze():
    stack = [(1, 1)]
    maze[1, 1] = 1
    while stack:
        x, y = stack[-1]
        neighbors = []
        for dx, dy in DIRS:
            nx, ny = x + dx, y + dy
            if 0 < nx < HEIGHT and 0 < ny < WIDTH and maze[nx, ny] == 0:
                neighbors.append((nx, ny))
        if neighbors:
            nx, ny = random.choice(neighbors)
            maze[(x + nx)//2, (y + ny)//2] = 1
            maze[nx, ny] = 1
            stack.append((nx, ny))
        else:
            stack.pop()

def bfs_shortest_path():
    start, goal = (1, 1), (HEIGHT-2, WIDTH-2)
    queue = deque([start])
    visited = set([start])
    parent = {}
    while queue:
        x, y = queue.popleft()
        if (x, y) == goal:
            break
        for dx, dy in [(-1,0),(1,0),(0,-1),(0,1)]:
            nx, ny = x+dx, y+dy
            if 0 <= nx < HEIGHT and 0 <= ny < WIDTH and maze[nx, ny] == 1 and (nx, ny) not in visited:
                visited.add((nx, ny))
                parent[(nx, ny)] = (x, y)
                queue.append((nx, ny))
    path, cur = [], goal
    while cur != start:
        path.append(cur)
        cur = parent.get(cur)
        if cur is None: return []
    path.append(start)
    path.reverse()
    return path

generate_maze()
path = bfs_shortest_path()

fig, ax = plt.subplots()
img = ax.imshow(maze, cmap='gray', vmin=0, vmax=1, interpolation='none')
ax.set_title("Shortest Path from Start to Goal")
ax.axis('off')

def update(frame):
    if frame < len(path):
        x, y = path[frame]
        ax.plot(y, x, 'ro', markersize=4)
    return [img]

ani = animation.FuncAnimation(fig, update, frames=len(path), interval=100, blit=False)
ani.save("maze_solution.gif", writer='pillow', fps=10)

plt.imshow(maze, cmap='gray', vmin=0, vmax=1, interpolation='none')
for x, y in path:
    plt.plot(y, x, 'ro', markersize=4)
plt.title("Final Maze with Shortest Path")
plt.axis('off')
plt.savefig("maze_solution.png", bbox_inches='tight', pad_inches=0.1)
plt.show()

BFSアルゴリズムの仕組み

BFS（幅優先探索）は、探索範囲を「階層的に」広げていくアルゴリズムです。

隣接ノードをすべて同時に探索するため、最初にゴールへ到達した経路が常に最短になります。DFSとの違いは、BFSが「最短距離保証型」である点にあります。

応用例の紹介

この迷路探索アニメーションは、教育・ゲーム・アルゴリズム可視化など、幅広い分野に応用できます。単なるプログラミング練習にとどまらず、実践的なシミュレーションや教材としても役立ちます。

1. アルゴリズム学習教材

DFS（深さ優先探索）やA*アルゴリズムなど、他の探索手法と比較することで、探索順序・効率・経路長の違いを視覚的に理解できます。アルゴリズム教育では「可視化」によって抽象的な概念が具体化し、理解度が大幅に向上します。

2. ゲーム開発

迷路ゲームの自動生成エンジンとして活用したり、敵キャラクターの経路探索ロジックに応用することが可能です。探索の進行をリアルタイムで描画すれば、プレイヤーが「見て楽しめるAI挙動」を作ることもできます。

3. ロボットの経路計画シミュレーション

実際のロボット工学でも、障害物を避けながらゴールへ進む「経路計画（Path Planning）」が重要なテーマです。今回のBFS迷路探索は、その基本概念を理解するための優れた入門例になります。

4. データ構造・グラフ理論の可視化

迷路は本質的に「グラフ構造（ノードとエッジ）」として表現できます。グラフ探索アルゴリズムを迷路で視覚化することで、理論的な学習を直感的に理解できるようになります。

さらに発展させるアイデア

• 迷路サイズ（WIDTH・HEIGHT）をユーザー入力で変更できるようにする
• 探索速度（interval）を調整してアニメーション速度を制御する
• DFSやA*など別のアルゴリズムと比較して、探索経路の違いを可視化する

動作確認環境

• Python 3.11
• matplotlib 3.9.2
• numpy 1.26+
• pillow 10.3.0

参考資料

• Python公式ドキュメント：collections.deque
• Wikipedia：Breadth-first search（幅優先探索）

まとめ

Python初心者でも取り組みやすく、アルゴリズムの理解にも役立つこの迷路探索アニメーション。

ぜひ自分なりに改造して、オリジナルの迷路アプリを作ってみてください！

しかし、「どの教材を選べばいいの？」「スクールって本当に必要？」と迷う方も多いのではないでしょうか。

この記事では、無料教材と有料スクールを徹底比較し、それぞれのメリット・デメリット、最適な使い分け方を2025年最新情報に基づいて解説します。
さらに、学んだスキルを使って副業収益化するための「クラウドソーシング実践ガイド」も紹介します。

筆者自身も未経験から独学＋スクールでスキルを身につけ、クラウドワークスで初案件を受注しました。その実体験をもとに、初心者が「学び→稼ぐ」までの最短ルートを徹底解説します。

プログラミングを学ぶ前に知っておきたいこと

プログラミングでできること

• Webサイト・アプリの開発（副業・在宅案件の定番）
• AI・データ分析（Pythonを使った需要急増分野）
• 業務の自動化（Excel・ChatGPT連携・RPAツールなど）

今やプログラミングは「エンジニア専用スキル」ではなく、副業・個人ビジネスの武器としても注目されています。
特にAI・自動化関連はクラウドワークスなどでも高単価案件が増加中です（出典：クラウドワークス2025年スキル需要レポート）。

PythonでCSVファイルから特定条件のデータを抽出したいと思ったことはありませんか？

この記事では、例として「温度が23℃以上のデータを抽出して別のCSVに保存する方法」を、初心者にもわかりやすく解説します。

さらに、GUIアプリ化して誰でも簡単に操作できる方法や、文字化けやエラーの対処法も紹介します。
最後に、業務や趣味で活用できる応用例まで紹介します。

前提と目的

まず、今回のサンプルCSVファイルには以下のようなデータが入っていると仮定します。

日付,時間,温度（℃）,湿度（％）
2025-09-24,10:00,22.5,60
2025-09-24,11:00,23.1,58
2025-09-24,12:00,24.0,55

この中から「温度が23℃以上」の行だけを抽出して、新しいCSVファイルに保存します。

サンプルCSVファイルのダウンロードはこちら

pandasを使った基本スクリプト

Pythonでは、データ処理に強いライブラリ「pandas」を使うと、条件抽出が驚くほど簡単にできます。
以下のコードは最小構成のサンプルです。

import pandas as pd

df = pd.read_csv('data.csv', encoding='utf-8')
filtered_df = df[df['温度（℃）'] >= 23]
filtered_df.to_csv('filtered_temperature.csv', index=False, encoding='utf-8-sig')

print("抽出結果を 'filtered_temperature.csv' に保存しました。")

このスクリプトを実行すると、23℃以上のデータのみが「filtered_temperature.csv」に保存されます。

よくあるエラーと対処方法

初心者が最初に躓きやすいのが、ライブラリの導入や文字コードの違いによるエラーです。
ここでは代表的な2つの例を紹介します。

エラー①：pandasがインストールされていない

ModuleNotFoundError: No module named 'pandas'

pip install pandas

エラー②：文字コードエラー

'utf-8' codec can't decode byte 0x93...

原因： CSVファイルがUTF-8以外（Shift_JISなど）で保存されている場合。

対処法①： Excelで開き、「CSV UTF-8（コンマ区切り）」で保存しなおす。
対処法②： 読み込み時に文字コードを指定する。

df = pd.read_csv('data.csv', encoding='cp932')

GUIアプリで抽出処理を簡単に！

コマンド操作が苦手な方でも簡単に使えるように、GUI（グラフィカルユーザーインターフェース）で動作するツールを作成してみましょう。
以下のコードを実行すると、ボタン操作だけでCSV選択・抽出・保存が可能になります。

import pandas as pd
import tkinter as tk
from tkinter import filedialog, messagebox

def select_file():
    filepath = filedialog.askopenfilename(filetypes=[("CSV files", "*.csv")])
    if filepath:
        try:
            df = pd.read_csv(filepath, encoding='utf-8')
            filtered_df = df[df['温度（℃）'] >= 23]
            save_path = filedialog.asksaveasfilename(defaultextension=".csv", filetypes=[("CSV files", "*.csv")])
            if save_path:
                filtered_df.to_csv(save_path, index=False, encoding='utf-8-sig')
                messagebox.showinfo("完了", "抽出結果を保存しました！")
        except Exception as e:
            messagebox.showerror("エラー", f"処理中にエラーが発生しました:\n{e}")

root = tk.Tk()
root.title("CSV温度抽出ツール")

label = tk.Label(root, text="CSVファイルを選択して、温度が23℃以上のデータを抽出します")
label.pack(pady=10)

button = tk.Button(root, text="CSVファイルを選択", command=select_file)
button.pack(pady=10)

root.mainloop()

GUI画面（ファイル選択ボタンと説明ラベル）

ファイル選択と抽出後のファイル保存先

ファイル選択画面

抽出後ファイルの保存先選択画面

データ抽出後のCSVファイル

【筆者のひとこと】
実際にTkinterでGUIツールを作ってみると、「思ったより簡単！」と感じる方が多いです。
社内の非エンジニアにも使ってもらいたい場合、こうしたGUI化は非常に有効です。

応用例：抽出機能を使ってこんなこともできる！

単純な温度抽出以外にも、pandasを使えば多彩な条件でデータ分析や整理ができます。

• 湿度が60%以上のデータだけ抽出：
  df[df['湿度（％）'] >= 60]
• 特定の日付のデータだけ抽出：
  df[df['日付'] == '2025-09-24']
• 複数条件で抽出（例：温度が23℃以上かつ湿度が50%以下）：
  df[(df['温度（℃）'] >= 23) & (df['湿度（％）'] <= 50)]
• 時間帯で抽出（例：午前中のデータ）：
  df[df['時間'].str.startswith(('08','09','10','11'))]
• 複数CSVを結合して一括抽出：
  pd.concat([pd.read_csv(f) for f in file_list])

【 活用例】
温度や湿度の管理、IoTデータの整理、センサーの異常値検知、品質管理など、業務シーンにも応用可能です。
個人でも「室温ロガー」や「植物の栽培データ」などに応用して楽しむことができます。

まとめ

• PythonとpandasでCSVの条件抽出はシンプルに実装できる
• GUI化すれば誰でも操作できるツールに進化
• 文字コードエラーはutf-8-sig指定で回避できる
• 抽出条件を変えるだけで幅広い分析や業務改善が可能

PythonのスクリプトをGUI化することで、チーム全体の業務効率を大幅に向上させることも可能です。
ぜひこの記事のサンプルを参考に、自分だけの「CSV抽出ツール」を作ってみてください。

サンプルCSVファイル配布

今回使用した温湿度データのCSVファイルを下記からダウンロードできます。
条件を変えて試してみることで、データ分析の感覚をつかめます。

サンプルCSVファイルのダウンロードはこちら

あわせて読みたい

• 【初心者向け】PythonでCSVファイルを読み書きする方法と活用アイデア｜業務効率化に最適！
• Pythonで画像を一括圧縮するGUIアプリの作り方【Tkinter + Pillow】
• 業務効率化に効く！Pythonレシピ集｜初心者〜中級者向けの実践テクニック10選

この記事では、実際に試した3つの方法とその結果、さらに現時点での最適解についてまとめます。

方法1：PyMuPDFでPDF化（テキスト抽出）

最初に試したのは、Pythonの人気PDFライブラリ「PyMuPDF（fitz）」を使って、WordやExcelの内容をテキストとしてPDFに出力する方法です。

コード：page.insert_textbox(rect, “”こんにちは世界””, fontsize=12)

しかし、PyMuPDFのデフォルトフォントは日本語に対応しておらず、「???」などの文字化けが発生。日本語文書には不向きでした。

出力されたPDF

成功：文字化けは解消

• Pillowで画像化
• MSゴシック（.ttc）を ImageFont.truetype() で読み込み
• PyMuPDFで画像をPDFに挿入

コード：font = ImageFont.truetype(“”C:/Windows/Fonts/msgothic.ttc””, 20, index=0)

出力されたPDF。文字が被ってますし罫線が四角形で表示されています。今の力ではここまでが限界でした。

元となったExcelファイル

import os
import io
from tkinter import Tk, Label, Button, filedialog, messagebox
from PIL import Image, ImageDraw, ImageFont
from docx import Document
from openpyxl import load_workbook
import fitz  # PyMuPDF

# MSゴシックフォント（.ttc形式）を指定
FONT_PATH = ""C:/Windows/Fonts/msgothic.ttc""
FONT_INDEX = 0  # MSゴシックは通常 index=0 でOK

def word_to_image_pdf(docx_path):
    try:
        doc = Document(docx_path)
        pdf_path = os.path.splitext(docx_path)[0] + ""_image.pdf""
        pdf = fitz.open()

        for para in doc.paragraphs:
            img = Image.new(""RGB"", (800, 600), ""white"")
            draw = ImageDraw.Draw(img)
            font = ImageFont.truetype(FONT_PATH, 20, index=FONT_INDEX)
            draw.text((50, 50), para.text, font=font, fill=""black"")

            img_bytes = io.BytesIO()
            img.save(img_bytes, format=""PNG"")
            img_bytes.seek(0)

            page = pdf.new_page(width=800, height=600)
            page.insert_image(fitz.Rect(0, 0, 800, 600), stream=img_bytes.read())

        pdf.save(pdf_path)
        pdf.close()
        return f""Word: {os.path.basename(docx_path)} → PDF変換成功""
    except Exception as e:
        return f""Word: {os.path.basename(docx_path)} → エラー: {e}""

def excel_to_image_pdf(xlsx_path):
    try:
        wb = load_workbook(xlsx_path)
        pdf_path = os.path.splitext(xlsx_path)[0] + ""_image.pdf""
        pdf = fitz.open()

        for sheet in wb.sheetnames:
            ws = wb[sheet]
            img = Image.new(""RGB"", (800, 600), ""white"")
            draw = ImageDraw.Draw(img)
            font = ImageFont.truetype(FONT_PATH, 16, index=FONT_INDEX)

            y = 50
            for row in ws.iter_rows(values_only=True):
                text = ""	"".join([str(cell) if cell else """" for cell in row])
                draw.text((50, y), text, font=font, fill=""black"")
                y += 30
                if y > 550:
                    img_bytes = io.BytesIO()
                    img.save(img_bytes, format=""PNG"")
                    img_bytes.seek(0)
                    page = pdf.new_page(width=800, height=600)
                    page.insert_image(fitz.Rect(0, 0, 800, 600), stream=img_bytes.read())
                    img = Image.new(""RGB"", (800, 600), ""white"")
                    draw = ImageDraw.Draw(img)
                    y = 50

            img_bytes = io.BytesIO()
            img.save(img_bytes, format=""PNG"")
            img_bytes.seek(0)
            page = pdf.new_page(width=800, height=600)
            page.insert_image(fitz.Rect(0, 0, 800, 600), stream=img_bytes.read())

        pdf.save(pdf_path)
        pdf.close()
        return f""Excel: {os.path.basename(xlsx_path)} → PDF変換成功""
    except Exception as e:
        return f""Excel: {os.path.basename(xlsx_path)} → エラー: {e}""

def select_word_files():
    filepaths = filedialog.askopenfilenames(filetypes=[(""Word files"", ""*.docx"")])
    if filepaths:
        results = [word_to_image_pdf(path) for path in filepaths]
        messagebox.showinfo(""Word変換結果"", ""\n"".join(results))

def select_excel_files():
    filepaths = filedialog.askopenfilenames(filetypes=[(""Excel files"", ""*.xlsx"")])
    if filepaths:
        results = [excel_to_image_pdf(path) for path in filepaths]
        messagebox.showinfo(""Excel変換結果"", ""\n"".join(results))

# GUI構築
root = Tk()
root.title(""Word/Excel 画像PDF変換ツール（MSゴシック .ttc対応）"")
root.geometry(""400x220"")

Label(root, text=""ファイルを画像としてPDFに変換"", font=(""Arial"", 14)).pack(pady=10)
Button(root, text=""Wordファイルを選択（複数可）"", command=select_word_files, width=30).pack(pady=5)
Button(root, text=""Excelファイルを選択（複数可）"", command=select_excel_files, width=30).pack(pady=5)

root.mainloop()

GUI

変換に成功するとこんな表示が出ます

課題点

今後の改善ポイント

実はPDFには圧縮しやすいタイプと、圧縮が効かないタイプがあります。

これを知らないまま圧縮ツールを試しても「なぜ小さくならないのか」がわからず、時間だけが過ぎていきます。

この記事では、PDFが圧縮できない原因を5つに分解し、それぞれの対処法を解説します。Adobe Acrobatで圧縮エラーが出る場合、図面PDFが圧縮されない場合、どちらにも対応。

さらに後半では、Pythonで大量のPDFを一括圧縮するGUIスクリプトも公開しています。

PDF圧縮できない原因5選（まずここを確認）

PDFが圧縮できない・サイズが小さくならない原因は、大きく5つに分けられます。

原因1：すでに圧縮済みのPDF

最もよくあるケースです。一度圧縮したPDFを再度圧縮しても、ほとんどサイズは変わりません。

PDF作成ソフト（Word→PDF変換やChromeの「印刷→PDF保存」など）が最初から圧縮設定を適用している場合、追加の圧縮は効きません。

対処法：元のファイル（Word、Excel等）から、圧縮設定を変えてPDFを再作成するのが確実です。

原因2：ベクター形式（図面PDF）で構成されている

AutoCADやJw_cadなどで作成された図面PDFは、画像ではなく「線や図形の数式データ」で構成されています。

一般的なPDF圧縮ツールは「画像の解像度を下げる」ことで圧縮しますが、ベクター形式のPDFには画像がないため、圧縮が効かない・エラーになることがあります。

実際にPythonのPyMuPDFで図面PDFを圧縮しようとした際、以下のようなエラーが出ました：

Error compressing sample_3.pdf: source or target not a PDF

対処法：Ghostscriptで再変換するか、Adobe Acrobatで「別名で保存」→構造を簡素化してから圧縮します（後述）。

原因3：Adobe Acrobatの圧縮設定が合っていない

Adobe Acrobatの「ファイルサイズを縮小」機能を使っても小さくならない場合、以下が原因であることが多いです↓

• 互換性設定が高すぎる（「Acrobat X以降」等にすると圧縮が甘くなる）
• 「最適化」ではなく「縮小」を使っている（「最適化」のほうが詳細に設定できる）
• フォント埋め込みが原因でサイズが大きくなっている

対処法：

1. 「ファイル」→「その他の形式で保存」→「最適化されたPDF」を選択
2. 画像の圧縮設定を「150dpi」以下に変更
3. 「フォント」タブでサブセット化されていないフォントを確認
4. 互換性を「Acrobat 5.0以降」に設定（古い形式ほど圧縮が効く）

原因4：セキュリティ設定（パスワード保護）がかかっている

PDFにパスワードや編集制限がかかっていると、圧縮ツールがファイルを正常に処理できないことがあります。

対処法：パスワードを解除してから圧縮してください。Adobe Acrobatなら「プロパティ」→「セキュリティ」から確認・解除できます。

原因5：PDF内に大量のメタデータ・注釈がある

コメント、マークアップ、フォーム、JavaScript、添付ファイルなどが含まれるPDFは、見た目以上にサイズが大きくなっていることがあります。

対処法：Adobe Acrobatの「最適化されたPDF」で「不要なオブジェクトを破棄」「ユーザーデータを破棄」にチェックを入れて保存します。

圧縮できるPDF vs 圧縮できないPDF（早見表）

PDF圧縮のおすすめツール比較

PDFの種類に応じて、適切なツールを選ぶことが重要です。

Ghostscriptで図面PDFを圧縮する（無料・オフライン）

ベクター形式の図面PDFにも対応したコマンドラインツールです。画質を調整しながら圧縮できます。

gswin64c -sDEVICE=pdfwrite -dCompatibilityLevel=1.4 -dPDFSETTINGS=/screen -dNOPAUSE -dBATCH -dQUIET -sOutputFile="output.pdf" "input.pdf"

PDF圧縮のデメリット・注意点

PDF圧縮は便利ですが、やりすぎると逆効果になるケースもあります。

• 画質の劣化：画像の解像度を下げすぎると、文字が読めなくなったり図面の細部が潰れたりする。特に図面PDFは注意
• テキストの検索性が失われる：画像化して圧縮すると、PDF内の文字検索（Ctrl+F）ができなくなることがある
• フォントが崩れる：フォントのサブセット化や除去により、別のPC/環境で開いたときにレイアウトが変わることがある
• 元に戻せない：圧縮後のPDFから元の画質には戻せない。必ず元ファイルを保管しておくこと

PythonでPDFを一括圧縮するGUIスクリプト

ここからはエンジニア・技術者向け。

以下は、画像ベースのPDFを対象に、一括圧縮できるPythonスクリプト（Tkinter GUI付き）です。

import fitz  # PyMuPDF
import os
import tkinter as tk
from tkinter import filedialog, messagebox
from tkinter import ttk

def is_valid_pdf(file_path):
    try:
        doc = fitz.open(file_path)
        doc.close()
        return True
    except:
        return False

def compress_pdf(input_path, output_path, zoom=0.5):
    try:
        doc = fitz.open(input_path)
        new_doc = fitz.open()
        for page in doc:
            pix = page.get_pixmap(matrix=fitz.Matrix(zoom, zoom))
            img_pdf = fitz.open("pdf", pix.tobytes())
            new_doc.insert_pdf(img_pdf)
        new_doc.save(output_path)
        new_doc.close()
        doc.close()
        return True
    except Exception as e:
        print(f"Error compressing {input_path}: {e}")
        return False

def batch_compress_pdfs(input_dir, output_dir, zoom=0.5, progress_callback=None):
    if not os.path.exists(output_dir):
        os.makedirs(output_dir)
    pdf_files = [f for f in os.listdir(input_dir) if f.lower().endswith(".pdf")]
    total_files = len(pdf_files)
    for i, filename in enumerate(pdf_files):
        input_path = os.path.join(input_dir, filename)
        output_path = os.path.join(output_dir, filename)
        success = compress_pdf(input_path, output_path, zoom) if is_valid_pdf(input_path) else False
        if progress_callback:
            progress_callback(i + 1, total_files, filename, success)

def start_compression():
    input_dir = input_dir_var.get()
    output_dir = output_dir_var.get()
    zoom = float(zoom_var.get())
    if not input_dir or not output_dir:
        messagebox.showerror("エラー", "入力フォルダと出力フォルダを選択してください。")
        return
    progress_bar["value"] = 0
    progress_bar["maximum"] = 100
    status_label.config(text="圧縮を開始します...")
    def update_progress(current, total, filename, success):
        percent = int((current / total) * 100)
        progress_bar["value"] = percent
        status = "✓" if success else "✗"
        status_label.config(text=f"{status} {filename} ({current}/{total})")
    batch_compress_pdfs(input_dir, output_dir, zoom, update_progress)
    messagebox.showinfo("完了", "PDFの圧縮が完了しました。")

def browse_input_folder():
    folder = filedialog.askdirectory()
    if folder:
        input_dir_var.set(folder)

def browse_output_folder():
    folder = filedialog.askdirectory()
    if folder:
        output_dir_var.set(folder)

# GUI setup
root = tk.Tk()
root.title("PDF一括圧縮ツール")

input_dir_var = tk.StringVar()
output_dir_var = tk.StringVar()
zoom_var = tk.StringVar(value="0.5")

tk.Label(root, text="入力フォルダ:").grid(row=0, column=0, sticky="e")
tk.Entry(root, textvariable=input_dir_var, width=50).grid(row=0, column=1)
tk.Button(root, text="参照", command=browse_input_folder).grid(row=0, column=2)

tk.Label(root, text="出力フォルダ:").grid(row=1, column=0, sticky="e")
tk.Entry(root, textvariable=output_dir_var, width=50).grid(row=1, column=1)
tk.Button(root, text="参照", command=browse_output_folder).grid(row=1, column=2)

tk.Label(root, text="圧縮率（例: 0.5）:").grid(row=2, column=0, sticky="e")
tk.Entry(root, textvariable=zoom_var, width=10).grid(row=2, column=1, sticky="w")

tk.Button(root, text="圧縮開始", command=start_compression).grid(row=3, column=1, pady=10)

progress_bar = ttk.Progressbar(root, length=400)
progress_bar.grid(row=4, column=0, columnspan=3, pady=5)

status_label = tk.Label(root, text="")
status_label.grid(row=5, column=0, columnspan=3)

root.mainloop()

よくある質問（FAQ）

Q. Adobe Acrobatで「ファイルサイズを縮小」してもサイズが変わらないのはなぜ？

すでに十分に圧縮されているか、テキスト主体のPDFで画像圧縮が効かない可能性があります。「その他の形式で保存」→「最適化されたPDF」を選ぶと、画像・フォント・不要オブジェクトを個別に設定して圧縮できます。互換性を「Acrobat 5.0以降」にすると、さらに効果が出ることがあります。

Q. 無料でPDFを圧縮するならどのツールがおすすめ？

一般的な用途ならPDF24 Tools（ブラウザ上で完結）が手軽。図面PDFやベクター形式ならGhostscript。大量ファイルの一括処理ならPython（PyMuPDF）。機密性の高いPDFはオンラインツールを避け、ローカルで処理するのが安全です。

Q. 圧縮したPDFの画質を元に戻せる？

戻せません。圧縮は不可逆処理なので、必ず元ファイルを保管してから圧縮してください。特に図面・契約書は「原本」と「共有用圧縮版」を分けて管理するのが鉄則です。

Q. PythonでPDFを圧縮するメリットは？

大量ファイルの一括処理ができること。100ファイル以上のPDFを手作業で1つずつ圧縮するのは非現実的ですが、Pythonなら数分で完了します。また、スクリプトを定期実行に組み込めば、日次・週次で自動圧縮する仕組みも作れます。

まとめ

PDF以外の業務も自動化したい方へ

Excel処理・ファイル整理・画像圧縮など、Pythonで自動化できる業務をまとめています。

→ AI×Pythonで業務を自動化する方法まとめ

文法がシンプルで学びやすく、初心者が最初に学ぶ言語としても選ばれることが多いです。

筆者がPythonを学び始めたきっかけは、ちょっとヨコシマな動機でした。

「株式の自動売買ツールを作ってみたい」と思ったのが始まりです。感情に流されず、システマチックに取引できる仕組みを作れれば勝てるかもしれない。そんな気持ちから調べ始めたところ、Pythonで実現できることを知り、学習をスタートしました。

実際にテスト環境で自動売買ツールを作ってみましたが、残念ながら勝てませんでした（笑）。

ただ、その過程でPythonの魅力にどんどん引き込まれ、今では業務効率化ツールや簡単なスクリプト開発など、幅広く活用しています。

たとえば自分で作ったPDF結合ツールは、今も実務で大活躍しています。市販のツールよりもシンプルで使いやすく、動作も速い。自分で作ったものが仕事で役立つ体験は、Python学習の大きなモチベーションになります。

このように、Pythonは「何かを自動化したい」「自分のアイデアを形にしたい」という人にぴったりの言語です。
とはいえ最近では教材が多く、「どれを選べば良いのかわからない…」という声も多いです。

そこで本記事では、初心者が安心して独学を始められるおすすめのPython教材を厳選し、効率的に学ぶステップもロードマップ形式で紹介します。
筆者の実体験をもとに、信頼できる教材選びと継続しやすい学習方法を解説します。

Python初心者が最初に覚えるべき基本コード10選｜業務改善にも使える入門ガイド「Pythonを学んでみたいけれど、何から始めればいいのかわからない…」 という方も多いのではないでしょうか。 実はPython...

Python教材の選び方

Pythonの学習教材は目的によって最適解が異なります。
たとえば「Web開発をしたい」「業務を自動化したい」「AIを学びたい」では、選ぶ教材のタイプが変わってきます。

はじめは無料教材や書籍で「Pythonの雰囲気」を掴み、その後、体系的に学べる動画コースや実践課題付きサービスへ進むと、挫折しにくくおすすめです。

おすすめ教材比較表

以下は、初心者〜中級者まで幅広く使われている代表的なPython教材を比較した表です。
いずれも多くの学習者から高い評価を得ており、独学でも十分にスキルを身につけられます。

教材	形式	特徴	対象者	価格
Udemy：Python完全入門コース	動画	体系的に学べる、演習豊富	初心者〜中級者	セール時 約1,500円
Progate：Python基礎コース	Web学習	ブラウザ完結、スライド形式	完全初心者	月額990円（12ヶ月プラン）
オンラインPython学習サービス「PyQ（パイキュー）」	実践型	実務に近い課題で学べる	副業・業務改善目的	月額3,040円〜（無料体験あり）
いちばんやさしいPython入門教室	書籍	図解豊富、基礎を固めやすい	書籍派・初心者	約2,200円
YouTube：Python講座チャンネル	動画（無料）	わかりやすい動画解説	気軽に学びたい人	無料

それぞれにメリット・デメリットがあるため、自分の目的や学習スタイルに合わせて選ぶのがコツです。

学習ステップロードマップ

ここでは、独学でPythonを習得するための具体的なステップを紹介します。
「何から始めればいいかわからない」という方は、このロードマップ通りに進めるだけでOKです。

各教材の詳細

1. Udemy：Python完全入門コース

2. Progate：Python基礎コース

3. PyQ：Python実践型学習サービス

4. 書籍：いちばんやさしいPython入門教室

5. YouTube：Python講座チャンネル

副業への活かし方

筆者自身もPythonを通じて、副業の可能性を広げています。
最初のきっかけとなった「自動売買ツール開発」は、まさにお金に働いてもらう仕組みを作る挑戦でした。今はまだ改良中ですが、Pythonを使えばそのようなアイデアも実現可能です。

また、ココナラなどのスキルマーケットを活用すれば、簡単なPythonスクリプト作成や自動化ツールの案件を受注できます。
学びながらスキルを実績に変え、収益化も目指せるのがPythonの魅力です。

学習のコツ

筆者が実践している学習法は「AIを使った逆算型学習」です。
ChatGPTなどのAIに「やりたいこと」を具体的に伝えると、スクリプトの骨組みをすぐに提示してくれます。
それを参考に「なぜこう書くのか？」を後追いで理解することで、短期間で効率的にスキルを吸収できます。

まとめ

Pythonは独学でも十分に習得可能なプログラミング言語です。
今回紹介した教材をうまく組み合わせれば、基礎から実践まで最短ルートで学習可能。

筆者のように、自分のアイデアを形にしたり、業務効率化ツールを作ったり、あるいは副業に挑戦したりと、Pythonの可能性は無限大です。
「少しでも興味がある」と思った今が、始めるチャンスです。