対象: Windows 10/11 + Cursor（VSCode系）を使っていて、PowerShell実行時に日本語が文字化けする人向け。

ゴール: Cursor の統合ターミナルで PowerShell 7（UTF‑8） を既定で起動し、出力・ファイル入出力・外部コマンドの日本語が崩れない状態にする。

TL;DR（最短手順）

PowerShell 7 を入れる：

winget install --id Microsoft.PowerShell -e

UTF‑8 に固定（PowerShell 7 側の $PROFILE に記述）：

notepad $PROFILE

開いたら以下を追記して保存：

[Console]::InputEncoding  = [System.Text.Encoding]::UTF8
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

Cursor の既定シェルを PowerShell 7 に変更：

設定 → Terminal › Integrated › Default Profile: Windows → PowerShell（= PowerShell 7）を選択。

出ない場合は settings.json に以下を追記：

{
  "terminal.integrated.defaultProfile.windows": "PowerShell7",
  "terminal.integrated.profiles.windows": {
    "PowerShell7": {
      "path": "C\\\\Program Files\\\\PowerShell\\\\7\\\\pwsh.exe",
      "icon": "terminal-powershell"
    }
  }
}

確認：

$PSVersionTable.PSVersion    # 7.x.x ならOK
[Console]::OutputEncoding    # utf-8 ならOK

1. なぜ文字化けするの？（背景）

Windows には Windows PowerShell 5.1（旧版）と PowerShell 7（現行）が共存します。
旧版 5.1 は既定が Shift_JIS（CP932）、現行 7 は UTF‑8 を前提としています。
Cursor/VSCode の既定シェルが 5.1 のままだと、日本語が化けやすいです。

自分がどっちを使っているか確認：

$PSHOME
# 例:
#   C:\Windows\System32\WindowsPowerShell\v1.0 → 5.1
#   C:\Program Files\PowerShell\7 → 7.x

2. PowerShell 7 を winget でインストール

winget install --id Microsoft.PowerShell -e

標準のパス：C:\Program Files\PowerShell\7\pwsh.exe

インストール後の確認：

where pwsh               # 見つかれば PATH 済み
"C:\Program Files\PowerShell\7\pwsh.exe"  # 直接起動も可
$PSVersionTable.PSVersion

PATH に出ない場合（where pwsh が空）：

環境変数 Path に C:\Program Files\PowerShell\7\ を追加 → 再起動
もしくは Cursor 側で pwsh.exe の絶対パスを指定（後述）

3. PowerShell 7 を UTF‑8 に“確実に”固定

3.1 `$PROFILE` に設定（推奨・一番確実）

notepad $PROFILE

以下を追記して保存：

[Console]::InputEncoding  = [System.Text.Encoding]::UTF8
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

$PROFILE の場所例：C:\Users\<User>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

3.2 `powershell.config.json` で全体設定（7.3+の補助手段）

7.3 以降で有効。環境全体で UTF‑8 にしたいときの補助として。

パス：C:\Program Files\PowerShell\7\powershell.config.json
例：

{
  "consoleInputEncoding": "utf-8",
  "consoleOutputEncoding": "utf-8"
}

変更後は 新しい pwsh プロセス を起動し直す。

4. Cursor の既定ターミナルを PowerShell 7 に変更

4.1 GUI で切り替え

設定 → Terminal › Integrated › Default Profile: Windows → PowerShell を選択。
- PowerShell が PowerShell 7、Windows PowerShell が 5.1 です。

4.2 `settings.json` で明示的に固定（出てこない場合）

{
  "terminal.integrated.defaultProfile.windows": "PowerShell7",
  "terminal.integrated.profiles.windows": {
    "PowerShell7": {
      "path": "C\\Program Files\\PowerShell\\7\\pwsh.exe",
      "icon": "terminal-powershell"
    }
  }
}

保存 → ターミナルを閉じて再度開く。

5. 動作確認（これだけ見ればOK）

$PSVersionTable.PSVersion
[Console]::OutputEncoding

# ファイル入出力の確認
"あいうえお" | Out-File .\utf8-test.txt -Encoding UTF8
Get-Content .\utf8-test.txt -Encoding UTF8

文字が崩れなければ成功。

6. よくあるハマりどころと解決策

Cursor で 5.1 が開く：
- Default Profile を PowerShell に直す / settings.json で固定。
- $PSHOME を確認して 7 のパスになっているかチェック。
where pwsh が空：
- C:\Program Files\PowerShell\7\pwsh.exe を直接起動、または PATH に追加。
UTF‑8 にならない：
- $PROFILE に 3 行を追記したか確認。新しいターミナルで再確認。
- 依然ダメなら powershell.config.json を併用し、完全に再起動。
5.1 をどうしても使う必要がある：
- セッション限定で：
```
chcp 65001
$OutputEncoding = [Console]::OutputEncoding = [Text.Encoding]::UTF8
```
- ただし根本解決は PowerShell 7 への移行。

7. 仕上げのチェックリスト

pwsh（7.x）が起動する
Cursor の Terminal Default Profile が PowerShell（7）
[Console]::OutputEncoding が utf-8 / CodePage 65001
ファイル入出力で日本語が崩れない

付録：コマンド早見表

# バージョン・場所
$PSVersionTable.PSVersion
$PSHOME
where pwsh

# プロファイルを開く（なければ作る）
notepad $PROFILE

# 一時的にUTF-8（5.1などの回避策）
chcp 65001
$OutputEncoding = [Console]::OutputEncoding = [Text.Encoding]::UTF8

以上。これで Cursor × PowerShell でも日本語の文字化けに悩まされません。