Cursorの自動保存機能の基本設定：MacとWindowsでどう変わる？
設定画面の開き方とAuto Saveオプションの場所
室谷代表取締役シリコンバレーのスタートアップだと、新人エンジニアに真っ先に教えるのが自動保存の設定なんですよね。Cursorも同じで、基本は設定画面でポチっとするだけ。
テキトー教師.AI認定講師でも最初に「Macで見つからない」って声をよく聞くんです。実はWindowsとMacで設定への入り方が微妙に違うんですよね。
室谷代表取締役そうそう。MacはCmd+、WindowsはCtrl+,で設定パネルを開いて、検索欄に「Auto Save」と打てばすぐ出てきます。
フォーラムにも同様の投稿がありました。
フォーラムにも同様の投稿がありました。
テキトー教師.AI認定講師最初に戸惑うのが「なんで設定が二段階なんだ」ってところですね。設定パネルの上の検索バーを使うのがコツです。
MacとWindowsでの設定項目の違い
テキトー教師.AI認定講師で、肝心の違いなんですけど、設定項目の内容自体はまったく同じです。off、onFocusChange、onWindowChange、afterDelayの4択。
室谷代表取締役USのエンジニアはほぼonFocusChangeかafterDelayにカスタムしてますね。デフォルトのまま使ってる人は少ない。
テキトー教師.AI認定講師たしかに。MacとWindowsでUIのレイアウトも全く一緒なので、違いを意識する必要はないですよ。
室谷代表取締役ただ、ショートカットだけはCmdとCtrlで違うので、そこだけ注意。WindowsからMacに移った人が間違えてCmd+Sで上書き保存しちゃうみたいな話はよくあります。
デフォルトの動作と変更時の注意点
テキトー教師.AI認定講師デフォルトはoffなんですけど、オンにするとタイムラインに自動保存の履歴が残るんです。手動保存と混ざって混乱する方も多い。
室谷代表取締役あれ、結構厄介で。フォーラムでも「手動保存だけに絞りたい」って声がありました。
Git使えって話もありますけど、Cursor内で完結させたい需要は大きい。
Git使えって話もありますけど、Cursor内で完結させたい需要は大きい。
テキトー教師.AI認定講師もう一つ注意なのが、プロジェクトに.vscodeフォルダがあると、そっちの設定が優先されること。知らずに上書きされて「変だな」ってなるケースが結構あります。
室谷代表取締役なるほど。そこはVSCodeから移行してきた人がハマるポイントですね。
自動保存の設定を変えても、プロジェクトのsettings.jsonが邪魔してるパターン。フォルダごと消せば直ります。
自動保存の設定を変えても、プロジェクトのsettings.jsonが邪魔してるパターン。フォルダごと消せば直ります。
VSCodeとCursorの自動保存の挙動の違い：onFocusChangeの落とし穴
files.autoSave設定のVSCodeとの互換性
室谷代表取締役シリコンバレーの開発現場だと、VSCodeからCursorに移行する人が多いんですけど、最初にハマるのが自動保存の挙動の違いなんですよね。特にonFocusChangeの動作が微妙に違うと。
テキトー教師.AI認定講師たしかに、VSCodeではウィンドウを切り替えたときも自動保存されるけど、Cursorだとそれが効かないって報告がありますね。
室谷代表取締役うちのチームでも「保存されてない！」って焦るケースがありました。結局、.vscodeフォルダの設定が悪さしてるパターンが大半でした。
onFocusChangeが意図通りに動かないケース
テキトー教師.AI認定講師フォーラムでも実際に「onFocusChangeにしてもウィンドウ切り替えで保存されない」って質問があって、解決策は.vscode/settings.jsonを削除することだったんですよ。
室谷代表取締役あれ、VSCodeの設定をそのまま持ってくると、Cursorのデフォルト設定とコンフリクトするケースがあるんですよね。経営目線でいうと、チームで.vscodeフォルダを共有してると厄介で。
テキトー教師.AI認定講師じゃあ、そのフォルダを消すか、明示的にCursor用の設定を上書きする必要があるってことですね。
室谷代表取締役そう。あとafterDelayのときにformatOnSaveが効かない問題もあって、そこは別の設定が必要です。
.vscodeフォルダによる影響と対策
テキトー教師.AI認定講師結局、.vscodeフォルダ内の設定がCursorの挙動を上書きしちゃってるんですね。フォーラムでも「削除したら直った」という解決策が紹介されてました。
室谷代表取締役プロジェクトによっては.vscodeをgit管理してるから簡単に消せない場合もありますよね。MYUUUの現場では、Cursor用に別の設定ファイルを作るか、ワークスペース設定で明示的に上書きするようにしてます。
テキトー教師.AI認定講師自動保存の挙動がおかしいと感じたら、まず.vscodeフォルダの有無を確認するのが第一歩ですね。
Agent編集時の自動保存が効かない問題：最新アップデートで何が変わった？
現象：Agent編集後に自動保存されない
室谷代表取締役最近のアップデートでAgentが編集したファイルが自動保存されなくなったって報告、結構見かけますね。シリコンバレーのスタートアップだと、Agentにコード修正させて即座にプレビュー確認するフローが普通なんで、これが効かなくなると生産性に直撃する。
テキトー教師.AI認定講師たしかに、フォーラムでも「Keepを押す前にファイルが保存されなくなった」って声が上がってました。以前はAgentが編集した時点で勝手に保存されてたのに、今はCommand+Sを手動で押さないと保存されないと。
室谷代表取締役うちの現場でも同じ現象が出てます。時給換算で考えると、いちいち手動保存する手間が塵積って結構なコストになるんですよね。
これ、何が原因なんでしょう？
これ、何が原因なんでしょう？
変更点：以前の「編集即保存」がどう変わったか
テキトー教師.AI認定講師原因はまだ明確ではないんですが、どうやらAuto Saveの設定を「off」にしていると、Agentによる中間保存がスキップされるタイミングがあるみたいです。以前はAuto SaveがoffでもAgentの編集は自動保存されてたんですが、アップデートでその挙動が変わった可能性があります。
室谷代表取締役なるほど。VSCodeベースのエディターあるあるですが、Cursor独自のAgent機能と標準のAuto Save設定の間に整合性が取れてなかったんでしょうね。
AnthropicのClaude Codeなんかも似たような課題を抱えてますが、Cursorはここをどう直すか。
AnthropicのClaude Codeなんかも似たような課題を抱えてますが、Cursorはここをどう直すか。
テキトー教師.AI認定講師フォーラムの投稿を見ると、Mac版で特に顕著で、Windows版ではまだ大丈夫という声もあります。環境依存かもしれないですね。
ワークアラウンド：手動保存と設定の見直し
室谷代表取締役とりあえずの対処法としては、Agent編集後にCommand+Sを習慣づけるか、Auto Saveの設定を「onFocusChange」や「afterDelay」に変えておくことですね。ただし、afterDelayにすると後述のフォーマット問題も起きるので注意が必要です。
テキトー教師.AI認定講師そうなんです。afterDelayにすると、フォーマットオンセーブが効かないという別の問題が発生するケースがある。
とりあえず今はonFocusChangeが無難かなという印象です。それか、自分はAgentが編集し終わったら、Ctrl+S（MacならCmd+S）を叩くのを癖にしてます。
とりあえず今はonFocusChangeが無難かなという印象です。それか、自分はAgentが編集し終わったら、Ctrl+S（MacならCmd+S）を叩くのを癖にしてます。
室谷代表取締役根本解決はCursor側のアップデート待ちですが、ワークアラウンドで回すなら手動保存ルールをチームで統一するのが現実的ですね。ROIで考えると、その程度の手間は許容範囲かもしれません。
自動保存とフォーマット機能の連携問題：afterDelay設定でPrettierが動かない
afterDelay設定でFormat on Saveが動作しない現象
テキトー教師.AI認定講師自動保存にafterDelayを設定すると、PrettierやESLintのフォーマットが走らないって話、現場でよく聞くんですよね。手動でCmd+Sを押せば動くのに、オートセーブだとスルーされる。
室谷代表取締役シリコンバレーのチームだと「保存時に自動フォーマット」が前提の文化なんで、これは結構クリティカルです。時給換算すると、無駄な手動保存の手間が塵積って月に数時間消えてる計算になる。
テキトー教師.AI認定講師最初に戸惑うのが「設定は正しいのにフォーマットされない」ってパターン。自動保存が介入すると、手動保存が実質no-opになるのが盲点ですね。
VSCode側の対応とCursorへの適用要望
室谷代表取締役実はVSCodeがv1.97（2025年1月）でafterDelay時のフォーマットオンセーブをサポートしたんですよ。Cursorはその変更を取り込めてない。
フォーク元が古いままだと結構しんどい。
フォーク元が古いままだと結構しんどい。
テキトー教師.AI認定講師コミュニティでも要望は上がってて、Cursor Forumにスレッドがありますよね。早く追従してほしいところ。
室谷代表取締役海外のCursorユーザーも同じ問題に当たってて、feature requestの投票数が伸びてる。経営目線で言うと、この手の「あるべき挙動との乖離」は開発者の集中力を削ぐので、早めの対応を期待したい。
onFocusChangeへの切り替えによる回避策
テキトー教師.AI認定講師とりあえずの回避策は、autoSaveをafterDelayからonFocusChangeに切り替えること。そうすればフォーマットが確実に動く。
室谷代表取締役ただ、onFocusChangeだとタブを離れるたびに保存されるから、編集中に頻繁に切り替える人は「保存しすぎ」と感じるかもしれない。現場のワークフロー次第で使い分けですね。
テキトー教師.AI認定講師はい。afterDelayにこだわる理由が特に無ければ、onFocusChangeで運用するのが今のところ無難です。
公式が対応するまでは、これが一番手軽な解決策かと。
公式が対応するまでは、これが一番手軽な解決策かと。
室谷代表取締役エンタープライズの導入事例でも、この辺の細かい挙動の差が「思ったよりコストがかかる」って話になるんですよね。自動保存の設定一つでROIが変わるので、チームで統一ルールを作るのがおすすめです。
.mdcファイル編集時の自動保存によるスクロールバグと対策
.mdcファイル編集中に自動保存とスクロールが発生する現象
テキトー教師.AI認定講師これ、結構報告が上がってるバグなんですよね。Cursorで.mdcファイルを編集してると、タイピング中に勝手に保存されて、しかも画面がファイルの先頭にスクロールしちゃう。
室谷代表取締役あー、シリコンバレーのコミュニティでも話題になってたやつですね。同一の.mdcファイルを複数人で触るようなチームだと、このバグで生産性がガクッと落ちるんですよ。
テキトー教師.AI認定講師そうです。私も最初「なんで毎回スクロール位置が飛ぶんだ？」と戸惑いました。
.mdcファイル限定ってのがまた厄介で。
.mdcファイル限定ってのがまた厄介で。
室谷代表取締役こういう細かいバグが積み重なると、時給換算で結構なロスになるんですよ。10人のチームが1日30分ロスしたら……まあ計算するまでもないですね。
Toggle Auto Saveコマンドを使った暫定対処
テキトー教師.AI認定講師で、今のところのワークアラウンドは、コマンドパレットから「Toggle Auto Save」を呼んで自動保存自体をオフにすることです。フォーラムのスレッドで解決策として承認されてました。
室谷代表取締役なるほど。自動保存を切っちゃえば当然スクロールも起きないと。
ただ、自動保存に頼ってる人は「保存し忘れ」リスクが出る。トレードオフですね。
ただ、自動保存に頼ってる人は「保存し忘れ」リスクが出る。トレードオフですね。
テキトー教師.AI認定講師その通りです。ただ、.mdcファイルを編集するときだけ一時的に切る運用にすれば、影響は最小限です。
手動でCmd+Sを習慣にするしかない。
手動でCmd+Sを習慣にするしかない。
室谷代表取締役USスタートアップだと、CIにプッシュする前に自動保存が走るのを嫌って、あえてonFocusChangeにしてるチームも多いんですよ。このバグがfixされるまで、そういう割り切りもアリかもしれません。
バグの再現手順と開発チームの対応状況
テキトー教師.AI認定講師再現手順は簡単で、Cursor IDEで.mdcファイルを開いて適当にタイピングするだけ。すると編集中に突然保存とスクロールが発生します。
OSはWindowsでもMacでも確認されてるみたいです。
OSはWindowsでもMacでも確認されてるみたいです。
室谷代表取締役このバグ、フォーラムだとv0.46から報告が上がってますね。開発チームは認識してるんですけど、まだ本格的な修正は出てない。
テキトー教師.AI認定講師そうなんですよね。スレッドは「Solved」になってますけど、それはあくまでワークアラウンドが見つかっただけで、根本的な修正じゃない。
室谷代表取締役こういう地味なバグって、Cursor側の優先度が低くなりがちなんですよね。ユーザーとしては、Gitでこまめにコミットするか、自動保存オフで乗り切るしかない。
業界構造として、エディタの安定性より新機能開発にリソースが割かれる傾向がある。
業界構造として、エディタの安定性より新機能開発にリソースが割かれる傾向がある。
自動保存と手動保存の履歴が混ざる：タイムラインの見分け方
タイムラインに表示されるautosaveと手動保存の違い
テキトー教師.AI認定講師タイムラインを見ると、自動保存と手動保存が同じリストに並ぶので、どれが自分の意図した保存か分からなくなる人が多いです。
室谷代表取締役シリコンバレーのエンジニアはこれを避けるために、自動保存をオフにして手動保存だけに頼る人が一定数いるんですよね。でもそれだとエディタの利便性が落ちる。
テキトー教師.AI認定講師現場でよく聞かれるのが「どのアイコンが手動保存？」という質問です。Cursorのタイムラインでは、自動保存と手動保存でアイコンが異なるんですが、見分け方の説明が少ないんです。
室谷代表取締役確かに。ただ、ソースにあるように、ユーザーから「自分の保存とautosaveの区別がつかない」という声が上がっていて、Gitの併用が推奨されてますね。
手動保存を確実に行うための習慣
テキトー教師.AI認定講師タイムラインが混ざる問題、結局は手動保存の習慣を身につけるのが一番の対策です。具体的には、ファイルを閉じる前に必ずCtrl+S（Cmd+S）を押すことですね。
室谷代表取締役あとは、設定で自動保存の間隔を長めにするか、onFocusChangeにしておくと、ファイル移動時にだけ保存されるので、タイムラインのノイズが減ります。
テキトー教師.AI認定講師注意点として、CursorのonFocusChangeはVSCodeと挙動が少し違うんです。ソースにもあるように、ウィンドウ切り替え時に保存されないことがあるので、完全に同じ感覚で使うと危ないです。
室谷代表取締役そこは意識しておいた方がいいですね。仕事の効率を考えると、確実に手動保存するルールを作った方がROIは高いです。
Gitによるバージョン管理の推奨
テキトー教師.AI認定講師タイムラインに頼るのではなく、Gitで管理するのが結局は確実です。ソースのフォーラムでも「Gitを使いなさい」というアドバイスがついていました。
室谷代表取締役その通り。Cursorのタイムラインは便利ですが、Gitほど堅牢ではない。
特に自動保存と手動保存が混ざると、どの時点に戻ればいいか分からなくなるリスクがあります。
特に自動保存と手動保存が混ざると、どの時点に戻ればいいか分からなくなるリスクがあります。
テキトー教師.AI認定講師初めてGitを使う人にはハードルが高いかもしれませんが、エディタの自動保存機能に頼りすぎると、いざという時に困ります。
室谷代表取締役MYUUUの現場でも、タイムラインの自動保存の履歴が邪魔でGitに移行したチームがいます。時給換算すれば、Gitの学習コストを回収するのは一瞬ですから。
自動保存機能の今後の展望：コミュニティの要望と改善の方向性
自動保存とドキュメント生成の自動化要望
室谷代表取締役シリコンバレーのチームだと、エージェントがコード変更したら自動でドキュメントも生成して保存するフローが当たり前になりつつあるんですよね。Cursorのフォーラムでも「Auto-create and auto-save documentation」って要望が上がってて。
テキトー教師.AI認定講師たしかに、手動で「ドキュメント作って」って頼むの、地味に面倒ですよね。でも、実はRulesで自動化できそうなんですよ。
室谷代表取締役なるほど。あれって「このルールがアクティブなら常にドキュメント生成を促す」みたいな設定ができるんでしたっけ。
テキトー教師.AI認定講師そうです。例えば「.pyファイルが変更されたら、自動でdocstringを生成して保存する」みたいなルールを書いておけば、手間がかなり減ります。
Rulesを使った自動保存のカスタマイズ例
テキトー教師.AI認定講師コミュニティでも「Rulesで自動保存のタイミングを調整できないか」って話が出てます。特に、エージェントがファイルを編集した直後に自動保存したいケース。
室谷代表取締役うちの現場でも、エージェントの編集を即座にサーバーに反映させたいっていう要望はよく聞きます。時給換算すると、手動保存の手間1回が意外とコストになってるんですよね。
テキトー教師.AI認定講師ただ、自動保存が強すぎると、今度は.mdcファイルのスクロールバグみたいな問題が起きる。フォーラムでも「Toggle Auto Saveで回避できる」って解決策が紹介されてました。
室谷代表取締役バランスが難しいですね。ユーザーが細かく制御できるように、Rulesで「このファイルタイプは自動保存しない」とか設定できると良さそう。
VSCodeアップストリームの取り込み期待
テキトー教師.AI認定講師CursorはVSCodeベースなので、アップストリームの改善がそのまま反映されることもありますよね。特に、VSCode v1.97で「afterDelayの自動保存時にもformatOnSaveが動くようになった」って変更があって、Cursorでも期待されてます。
室谷代表取締役あれ、結構大きい変更ですよね。今CursorだとafterDelayで自動保存するとPrettierやESLintのfixが走らないから、手動保存必須になってる。
テキトー教師.AI認定講師フォーラムでもFeature Requestとして上がってます。「onFocusChangeにすれば動く」というワークアラウンドはあるんですが、afterDelayを使いたい人には辛い。
室谷代表取締役これはもうアップストリームを取り込むのが一番早い。単なるバグ報告じゃなくて、業界全体の流れとして「自動保存時のフォーマット実行」が標準になりつつあるので、早めに対応してほしいところですね。
よくある質問
Q1. Cursorで自動保存と同時にドキュメントを自動生成する機能はある？設定方法は？
室谷代表取締役これ、僕も気になってフォーラムで見たんですが「Auto create and auto save documentation」って機能が一応あるんですよね。ドキュメント生成の自動化みたいな文脈で議論されてた
テキトー教師.AI認定講師ああ、それ初めて聞きました。具体的にはどういう場面で使う想定なんですか？
室谷代表取締役まだ実験的な機能っぽくて、公式のドキュメントから自動生成する感じ。現時点では全ユーザーが使えるわけじゃないかもしれないですけど、フォーラムで要望が上がってる
Q2. 手動保存と自動保存の履歴はタイムライン上でどのように区別すればいい？
室谷代表取締役タイムラインで両方出てくると混乱しますよね。フォーラムでも「My saves vs autosaves」ってスレッドが立ってて、見分け方として手動保存はファイル名の横に小さなマークが付くとか
テキトー教師.AI認定講師たしかに。自動保存の履歴だけ非表示にしたいケースもあるんですが、現状はフィルター機能が無くて、一つ一つ確認するしかないみたいです
室谷代表取締役今後の改善要望としては挙がってるんで、次のアップデートで対応されるかもしれませんね。差し当たりは手動保存を習慣にした方が混乱しないかも
Q3. Macで自動保存が効かない場合、設定ファイルのどこを確認すればいい？
室谷代表取締役Mac特有の話なんですが、フォーラムに「Auto save on Mac」ってスレッドがあって、どうやらfiles.autoSaveの設定だけじゃなくて、システムの省電力設定やフォーカスモードが干渉することがあるみたいです
テキトー教師.AI認定講師ああ、それは意外な落とし穴ですね。Windowsと違ってMacはアプリのバックグラウンド動作に制限がかかりやすいから、自動保存が正しくトリガーされないことがあると
室谷代表取締役そう。設定はCursorの設定JSONで確認できますが、それでも効かない場合はシステム環境設定の「バッテリー」や「省エネルギー」をチェックした方がいいですね
Q4. Agent編集時に自動保存を有効にするための特別な設定は必要？
室谷代表取締役Agentモードだと自動保存が効かないって報告がフォーラムにありますね。これ、特別な設定が必要というより、バグの可能性が高い
テキトー教師.AI認定講師つまり、普通のエディタモードと同じ設定では動かないと。じゃあ現状の回避策としては手動保存（Cmd+S）をこまめに押すしかないですかね
室谷代表取締役そうです。最新のアップデートで改善されたという話もあるので、バージョンを確認してみてください。
もし頻繁に使うなら一度アンインストールして再インストールすると直るケースもあったとか
もし頻繁に使うなら一度アンインストールして再インストールすると直るケースもあったとか
Q5. afterDelay設定でフォーマットが動かない問題は、特定の拡張機能との競合が原因？
室谷代表取締役afterDelayの自動保存時にフォーマットがかからない件、フォーラムでは「format on save should trigger during auto save afterdelay」ってスレッドが立ってますね
テキトー教師.AI認定講師これはPrettierなどのフォーマッタが自動保存のタイミングで起動しない問題らしい。拡張機能のせいではなくて、Cursor側のイベント発火の仕様だと思います
室谷代表取締役回避策として、一旦afterDelayをオフにして手動保存にフォーマットを任せるか、もしくは保存のトリガーをonFocusChangeにすると動く場合があるそうです。根本的には修正待ちですね
まとめ
室谷代表取締役Cursorの自動保存機能、シリコンバレーの開発現場でも「これが無いとやってられない」ってレベルで使われてるんですけど、日本だとまだトラブルにハマる人が多い
テキトー教師.AI認定講師そうですね。基本設定は簡単ですが、VSCodeと挙動が微妙に違ったり、Agentモードや.mdcファイルでバグがあったりと、想定外の挙動に戸惑う人は多いと思います
室谷代表取締役特にafterDelayとフォーマットの連携問題は結構深刻で、ROIで考えると手動保存に切り替えた方がストレスフリーという判断もあり得る
テキトー教師.AI認定講師現場感覚で言うと、まずは基本のonFocusChangeで運用してみて、自分たちのワークフローに合わなければafterDelayや手動を組み合わせるのが無難です
室谷代表取締役今後もフォーラムで改善要望が上がっているので、アップデートをこまめにチェックして、新しい機能が出たらすぐ試すのがいいと思いますね。まとめると、自動保存に頼りすぎず、自分に合った設定を見つけるのが吉です
出典
- Auto save on Mac
- Automatic file saving and view scrolling occur when editing .mdc files in Cursor IDE on Windows disrupting the editing workflow
- Different behavior of files autosave onFocusChange configuration compared to VSCode
- Autosave file when editing Agent
- My saves vs autosaves
- Auto create and auto save documentation
- Format on save should trigger during auto save afterdelay
