Xcode 27でPlaygroundに新しいページを追加しようとすると、従来のメニュー項目が見つからず、キーボードショートカットから実行しても「No valid file actions for insertion.」と表示されることがあります。Apple Developer ForumsではXcode 27 beta 6での発生が報告されています。本記事では、確認できている発生条件、誤操作との切り分け、安全な代替手段を説明します。
表示されるエラー
No valid file actions for insertion.報告例では、以前存在したFile > New > Playground Pageが見当たらず、既存のショートカットを実行すると上記エラーになります。
原因
このメッセージは、Xcodeが現在の選択位置に対して実行可能な「ファイル挿入」アクションを見つけられないときに表示されます。Xcode 27 beta 6の報告では、複数ページPlayground用のメニュー項目自体が消えているため、単なるショートカット入力ミスではなく、Xcode 27側のUIまたはPlayground編集機能の変更が関係している可能性があります。
公式状況：Apple Developer Forumsには具体的な再現報告がありますが、Appleのリリースノートでは、本件が仕様変更なのか不具合なのか、また修正版がどのバージョンなのかは確認できていません。そのため「特定の設定変更で必ず直る」とは断定できません。
発生条件・対象バージョン
- 報告が確認できる環境：Xcode 27 beta 6
- 既存のPlaygroundで新しいページを追加しようとする
- File > New > Playground Pageが表示されない
- 以前のキーボードショートカットを実行するとエラーが出る
Xcode 27の正式版や後続アップデートですべての環境に再現するとは公式確認されていません。まず手元の正確なビルド番号を記録してください。
xcodebuild -version推奨する確認・対処手順
- Xcodeを利用可能な最新の正式版へ更新します。beta版のままなら、正式版またはより新しいbetaで同じ操作を再確認してください。更新で直ることは保証されていないため、作業前にPlaygroundをバックアップします。
- Project Navigatorで、通常のSwiftファイルではなく
.playground本体または既存ページを選択してから、Fileメニューを確認します。 - 新規の最小Playgroundを作り、同じメニューとショートカットを確認します。新規ファイルでも再現すれば、個別Playgroundの破損よりXcode側の挙動である可能性が高まります。
- 通常のSwiftファイル作成が必要なだけなら、Playground Pageではなく、PlaygroundのSourcesへ補助コードを分離します。
- 複数の独立した実行例が必要なら、それぞれを別の
.playgroundとして作成します。
代替策
1. 単一Playgroundを複数ファイルへ分ける
共有する型や関数をSourcesへ置き、実行コードだけをPlayground本体に残します。これは「ページ追加」と完全に同じ構造ではありませんが、コードの分割には利用できます。
// Sources/ExampleSupport.swift
public func greeting(_ name: String) -> String {
"Hello, \(name)"
}
// Playground main page
let message = greeting("Xcode")2. 複数のPlaygroundを作る
各サンプルを独立したPlaygroundに分ければ、ページ追加アクションに依存せず実行できます。共有コードが多い場合はSwift Packageへ移す方法もあります。
3. Xcode 26.6以前で既存Playgroundを編集する
旧環境でページ追加が必要な場合の暫定策です。旧版で編集する前に、PlaygroundをGitなどで保存し、Xcode 27で再び開いた後に差分と実行結果を確認してください。Appleが公式に推奨した修正手順ではありません。
確認方法
xcodebuild -versionの結果を記録する- 新規の最小PlaygroundでFileメニューを確認する
- Playground Pageの項目がある場合はページを追加し、追加したページが実行できるか確認する
- 項目がない場合は、Sources分割または別Playgroundでコードが実行できるか確認する
- 問題が継続する場合は、Xcodeのビルド番号、macOSバージョン、Playground形式、再現手順を添えてFeedback Assistantへ報告する
注意点
.playgroundパッケージ内部をFinderやテキストエディタで直接編集すると、参照情報を壊す可能性があります。必ずバックアップを作成してください。- DerivedDataの削除はビルドキャッシュ問題には有効な場合がありますが、メニュー項目が存在しない問題を直す公式手順ではありません。
- Swift Playgroundsアプリのプロジェクトと、Xcodeの
.playgroundは同じものではありません。対象を取り違えないでください。 - 公式修正版は確認できていないため、特定バージョンへの更新だけで解消すると断定しないでください。
まとめ
Xcode 27で「No valid file actions for insertion.」が出る場合、現在の選択位置に追加可能なPlayground Pageアクションがなく、Xcode 27側で従来の追加機能を利用できない状態になっています。最新版で再確認したうえで、当面はSourcesへの分割、別Playground、Swift Packageへの移行を検討してください。Appleによる原因や修正版の確定情報はまだ確認できないため、再現環境を添えてFeedback Assistantへ報告するのが安全です。
参照した公式情報
