Linux Mint環境におけるCursorのアップデート手順
1. 概要(現在の構成)
当開発環境(Linux Mint)におけるCursorは、一般的な .deb パッケージによる管理ではなく、AppImage形式の本体ファイルを改名し、手動でパスを通した構成(~/.local/bin/cursor)で動作しています。
そのため、Cursorアプリ内からの自動アップデート機能は動作しません。アップデート通知が届いた場合は、以下の手順に従って手動でファイルを差し替える必要があります。
2. 手動アップデート手順
ステップ1:最新のAppImageをダウンロード
- ブラウザで Cursor公式サイト にアクセスします。
- Linux用の AppImage をダウンロードします。
- (通常は
~/Downloadsフォルダにcursor-xxxxx.AppImageのような名前で保存されます)
ステップ2:ファイルの差し替え(配置)
- 起動しているCursorを完全に終了します。
- ファイルマネージャーを開き、ホームフォルダに移動します。
- Ctrl + H キーを同時に押し、隠しフォルダを表示させます。
.(ドット)から始まる.local➔binフォルダの順に開きます。- フォルダ内にある古いファイル(名前:
cursor)を削除します。- ※ 念のため、初回は
cursor_oldなどにリネームしてバックアップを取ることを推奨します。
- ※ 念のため、初回は
- ステップ1でダウンロードした最新の
cursor-xxxxx.AppImageファイルを、このbinフォルダ内に移動します。 - 移動した最新ファイルのファイル名を、拡張子を消して
cursor(すべて小文字)に変更(リネーム)します。
ステップ3:実行権限の付与
- 名前を
cursorに変更したファイルを右クリックし、「プロパティ」を開きます。 - 「アクセス権」タブを開きます。
- 「プログラムとして実行可能にする」にチェックを入れ、プロパティ画面を閉じます。
- Ctrl + H キーを押し、隠しフォルダを非表示に戻します。
以上でアップデートは完了です。既存の設定、拡張機能、プロジェクトファイルは自動的に引き継がれます。
3. トラブルシューティング
Q. アップデート後、メニューからCursorが起動しなくなった
原因の可能性1:ファイル名の間違いbin フォルダ内に配置したファイル名が、正確に cursor になっているか確認してください(.AppImage などの拡張子がついたままだと起動しません)。
原因の可能性2:実行権限の付け忘れ
ステップ3の「プログラムとして実行可能にする」のチェックが外れていないか再確認してください。ターミナルで実行する場合は以下のコマンドで権限を付与できます。
chmod +x ~/.local/bin/cursor
Q. 現在の起動パスやファイルの実体をコマンドで確認したい
ターミナルを開き、以下のコマンドを実行することで、システムがどのCursorを認識しているか確認できます。
which cursor
# 正常な出力例: /home/(ユーザー名)/.local/bin/cursor
こちらの内容で、引き継ぎ書として十分な情報が網羅されているかと思います。
もし追加したい独自のルールや、社内の共有ツールの形式(Notion、Markdown、テキストファイル等)に合わせた微調整が必要であれば、お気軽にお申し付けください。
