環境構築
Failed to save: Unable to write file (NoPermissions)
ファイルに書き込み権限がない
こんな症状
VS Codeでファイルを保存しようとすると権限エラーが出る。ファイルの権限設定で起きるよ。
まず試す
プロジェクトをデスクトップやドキュメントなど権限のある自分のフォルダに移動する。
env
# プロジェクトを自分のフォルダに移動（最も確実）
mv /opt/my-site ~/Documents/my-siteこれで直らなければ、下の「自分のケース」を確認。
🔍 自分のケースはどれ？
- ✓Program Files など権限が要る場所で作業
→ 自分のフォルダ（デスクトップ/ドキュメント）に移す。 - ✓Mac/Linux で権限が無い
→ sudo chown -R $(whoami) フォルダ で所有者を自分にする。 - ✓Windows で書き込めない
→ フォルダを右クリック→プロパティ→セキュリティで権限を確認する。
なぜ起きる？
ファイルやフォルダに書き込み権限がない、または管理者権限が必要なディレクトリ（Program Files等）で作業しているよ。OSはファイルごとに読み取り/書き込み/実行の権限を管理していて、権限がないと保存できないんだ。
✕ エラーが起きるコード
# VS Codeで保存（Ctrl+S）すると右下に表示される
# Failed to save 'index.html': Unable to write file
# (NoPermissions (FileSystemError): Error: EACCES: permission denied)✓ 直したコード
# 1. プロジェクトを自分のフォルダに移動（最も確実）
$ mv /opt/my-site ~/Documents/my-site
# 2. Mac/Linux: フォルダの所有者を自分にする
$ sudo chown -R $(whoami) ~/Documents/my-site✅ 直ったか確認
保存（Ctrl+S）がエラーなく完了すればOK。
この解決法は役立ちましたか？
🔗 関連するエラー
- VS Codeの拡張機能が動かない・反映されない — 再起動・有効化・追加設定のどれかが足りていない
- Live Serverが起動しない — Live Server 拡張機能が正しく動作していない
- fatal: unable to access — リモートリポジトリに接続できない
- Permission denied — 権限が不足している
- PermissionError: [Errno 13] Permission denied (Python) — ファイルへのアクセス権限がない
🔗 別カテゴリの関連エラー
📖 この問題を学べるレッスン
📝 関連ブログ記事
- プログラミングのエラーメッセージの読み方 — エラーの読み方を基礎から解説
- VS Codeのインストール方法 — インストールと初期設定を図解で解説
- プログラミング初心者が最初にやるべきこと5選 — 目的を決めて環境構築から