如果 Cursor AppImage 安装到 Ubuntu 系统中(而不是每次手动运行 .AppImage
文件),可以按照以下方法操作:
方法 1:直接运行 AppImage(最简单,但不完全“安装”)
- 赋予执行权限
chmod +x Cursor-0.48.6-x86_64.AppImage
- 运行
./Cursor-0.48.6-x86_64.AppImage
- 如果报错(如 sandbox 问题),可以尝试:
./Cursor-0.48.6-x86_64.AppImage --no-sandbox
- 如果报错(如 sandbox 问题),可以尝试:
方法 2:安装 AppImage 到系统(推荐)
步骤 1:将 AppImage 移动到 /opt
(可选)
sudo mkdir -p /opt/cursor
sudo mv Cursor-0.48.6-x86_64.AppImage /opt/cursor/
sudo chmod +x /opt/cursor/Cursor-0.48.6-x86_64.AppImage
步骤 2:创建桌面启动器(.desktop
文件)
nano /usr/share/applications/cursor.desktop
粘贴以下内容(调整路径):
[Desktop Entry]
Name=Cursor
Exec=/opt/cursor/Cursor-0.48.6-x86_64.AppImage --no-sandbox
Icon=cursor
Terminal=false
Type=Application
Categories=Development;IDE;
StartupWMClass=cursor
保存 (Ctrl+O
→ Enter
→ Ctrl+X
)。
步骤 3:赋予权限并更新菜单
sudo chmod +x /usr/share/applications/cursor.desktop
update-desktop-database /usr/share/applications/
现在可以在 Ubuntu 应用菜单中找到 Cursor 并启动。
方法 3:提取 AppImage 并安装(可选)
如果你想完全提取 AppImage 并安装:
./Cursor-0.48.6-x86_64.AppImage --appimage-extract
cd squashfs-root
sudo cp -r . /opt/cursor/
sudo ln -s /opt/cursor/AppRun /usr/local/bin/cursor # 创建软链接
然后创建 .desktop
文件(参考方法 2)。
如果报错
(base) li@li-mobo:/opt/Cursor %./AppRun
[62764:0414/174146.960220:FATAL:setuid_sandbox_host.cc(163)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /opt/Cursor/usr/share/cursor/chrome-sandbox is owned by root and has mode 4755.
追踪或断点陷阱 (核心已转储)
这个错误是因为 Chrome 沙盒(sandbox) 没有正确配置。Cursor(基于 Electron/Chromium)需要
chrome-sandbox
文件具有 SUID 权限(即4755
并属于root
)。以下是解决方法:
方法 1:修复
chrome-sandbox
权限
- 进入 Cursor 的安装目录:
bash cd /opt/Cursor/usr/share/cursor/
- 修改
chrome-sandbox
的权限和所有者: ```bash sudo chown root:root chrome-sandbox # 设置所有者为 root sudo chmod 4755 chrome-sandbox设置 SUID 权限 ```
- 重新运行 Cursor:
bash /opt/Cursor/AppRun
方法 2:禁用沙盒(不推荐,仅作备用) 如果问题仍然存在,可以临时禁用沙盒(降低安全性):
- 在终端中运行:
bash /opt/Cursor/AppRun --no-sandbox
- 或修改桌面快捷方式(
~/.local/share/applications/cursor.desktop
),在Exec
行添加--no-sandbox
:ini Exec=/opt/Cursor/AppRun --no-sandbox %U
方法 3:重新解压 AppImage 如果文件损坏,重新解压 AppImage: ```bash cd /opt rm -rf Cursor # 删除旧文件 ./Cursor.AppImage --appimage-extract # 重新解压 mv squashfs-root Cursor # 重命名文件夹 cd Cursor/usr/share/cursor/ sudo chown
root:root chrome-sandbox sudo chmod 4755 chrome-sandbox ```
原因说明
- Chromium/Electron 应用依赖
chrome-sandbox
进行进程隔离(安全机制)。- SUID(
4755
)允许普通用户以root
权限运行沙盒,但必须严格限制文件归属。完成后应该能正常启动 Cursor。
卸载方法
- 删除 AppImage 文件
sudo rm -rf /opt/cursor/Cursor-*.AppImage # 如果放在 /opt rm ~/Applications/Cursor-*.AppImage # 如果用 appimagelauncher
- 删除
.desktop
文件rm ~/.local/share/applications/cursor.desktop
总结
- 推荐方法: 方法 2(手动安装)。
- 如果遇到沙盒问题,运行时要加
--no-sandbox
。 - 如果希望更新,只需替换
.AppImage
文件即可。
安装文件图标
sudo cp cursor.png /usr/share/icons/
更新.desktop 文件
Icon=cursor # 直接写文件名(无扩展名)
强制刷新桌面数据库
xdg-desktop-menu forceupdate
killall gnome-shell # GNOME环境需要
设置Cursor的命令
# ~/.bashrc
alias cursor="/opt/cursor/Cursor-0.48.6-x86_64.AppImage --no-sandbox"
还有一种方法:使用Deb安装包,但是不支持最新版本(也没法通过应用程序内的更新)
使用Cursor的deb安装包, 链接如下:
https://downloader.cursor.sh/linux/deb/x64 (For x86 chips)
https://downloader.cursor.sh/linux/deb/arm64 (For arm chips)
可以解决该问题