PyEnchant (Python で動くスペルチェッカー) のインストールと試用（Windows 上）

1. エグゼクティブサマリー

Windows での，PyEnchant のインストール手順を説明する．

PyEnchant は，英語のスペルチェックと，正しい単語の提案の機能を持ったパッケージである．本記事では，インストールから動作確認までの手順を示す．動作確認では，単語の正誤判定，修正候補の提案，および文章全体のスペルチェックを扱う．

URL: https://pyenchant.github.io/pyenchant/

2. 前準備（必要ソフトウェアの入手）

ここでは、最低限の事前準備について説明する。機械学習や深層学習を行う場合は、NVIDIA CUDA、Visual Studio、Cursorなどを追加でインストールすると便利である。これらについては別ページ https://www.kkaneko.jp/cc/dev/aiassist.htmlで詳しく解説しているので、必要に応じて参照してください。

Python 3.12 のインストール（Windows 上） [クリックして展開]

以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。

方法1：winget によるインストール

管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install --scope machine --id Python.Python.3.12 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0 Include_launcher=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2：インストーラーによるインストール

Python 公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
ダウンロードしたインストーラーを実行する。
初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

AIエディタ Windsurf のインストール（Windows 上） [クリックして展開]

Pythonプログラムの編集・実行には、AIエディタの利用を推奨する。ここでは、Windsurfのインストールを説明する。Windsurf がインストール済みの場合、この手順は不要である。

winget install --scope machine --id Codeium.Windsurf -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --custom "/SP- /SUPPRESSMSGBOXES /NORESTART /CLOSEAPPLICATIONS /DIR=""C:\Program Files\Windsurf"" /MERGETASKS=!runcode,addtopath,associatewithfiles,!desktopicon"
powershell -Command "$env:Path=[System.Environment]::GetEnvironmentVariable('Path','Machine')+';'+[System.Environment]::GetEnvironmentVariable('Path','User'); windsurf --install-extension MS-CEINTL.vscode-language-pack-ja --force; windsurf --install-extension ms-python.python --force; windsurf --install-extension Codeium.windsurfPyright --force"

【関連する外部ページ】

Windsurf の公式ページ: https://windsurf.com/

必要なライブラリのインストール [クリックして展開]

python -m pip install -U pip setuptools

python -m pip install pyenchant

3. 実行のための準備とその確認手順（Windows 前提）

3.1 プログラムファイルの準備

第5章のソースコードをテキストエディタ（メモ帳，Windsurf 等）に貼り付け，spellcheck.py として保存する（文字コード：UTF-8）．

3.2 実行コマンド

コマンドプロンプトでファイルの保存先ディレクトリに移動し，以下を実行する．

python spellcheck.py

3.3 動作確認チェックリスト

https://pyenchant.github.io/pyenchant/tutorial.html で公開されているプログラムを使用する．

確認項目	期待される結果
`d.check("Hello")` の実行	`True` が表示される（正しいスペル）
`d.check("Helo")` の実行	`False` が表示される（誤ったスペル）
`d.suggest("Helo")` の実行	修正候補のリスト（例：`['He lo', 'He-lo', 'Hello', ...]`）が表示される
SpellChecker による文章全体のチェック	誤りのある単語（`sme`，`txt`，`erors`）と修正候補が表示される

4. 概要・使い方・実行上の注意

PyEnchant は，英語のスペルチェックと，正しい単語の提案の機能を持ったパッケージである．ソースコードは第5章に掲載する．

4.1 単語単位のスペルチェックと修正候補の提案

enchant.Dict("en_US") で米国英語の辞書オブジェクトを生成する．check() メソッドは，スペルが正しければ True，誤りがあれば False を返す．suggest() メソッドは，誤りのある単語に対する修正候補をリストで返す．

4.2 文章全体のスペルチェック

enchant.checker モジュールの SpellChecker クラスにより，文章全体のスペルチェックを実行できる．set_text() で対象文章を設定し，イテレータで誤りのある単語を順に取得する．各エラーオブジェクトの word 属性でエラー単語を，suggest() メソッドで修正候補を取得できる．

5. ソースコード

5.1 単語単位のスペルチェック

enchant.Dict を用いて，単語の正誤判定と修正候補の取得を行う．

import enchant
d = enchant.Dict("en_US")
print(d.check("Hello"))
print(d.check("Helo"))
print(d.suggest("Helo"))

5.2 文章全体のスペルチェック

SpellChecker を用いて，文章全体からスペルミスを検出し，各エラーと修正候補を表示する．

from enchant.checker import SpellChecker
chkr = SpellChecker("en_US")
chkr.set_text("This is sme sample txt with erors.")
for err in chkr:
    print("ERROR:", err.word, "-> Suggestions:", err.suggest())

6. まとめ

PyEnchant パッケージ

PyEnchant は，英語のスペルチェックと，正しい単語の提案の機能を持ったパッケージである．

enchant.Dict による単語チェック

enchant.Dict("en_US") で辞書オブジェクトを生成し，check() メソッドで単語の正誤を判定する．

suggest() による修正候補の提案

suggest() メソッドにより，誤りのある単語に対する修正候補がリスト形式で返される．

SpellChecker による文章全体のチェック

enchant.checker モジュールの SpellChecker クラスにより，文章全体のスペルチェックを実行できる．イテレータで誤りのある単語を順に取得し，各エラーに対して修正候補を得られる．

pip によるインストール

PyEnchant は python -m pip install pyenchant でインストールできる．Windows では，コマンドプロンプトを管理者として開いて実行する．