更新记录

0.0.1（2025-08-05） 下载此版本

右键菜单添加“Open in Cursor”

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

# HG-HX2Cursor 插件使用说明

插件简介

HG-HX2Cursor 是一个专为 HBuilderX 开发的插件，它允许您快速在 Cursor 编辑器中打开当前正在编辑的文件，并自动定位到光标所在位置。这个插件为需要在 HBuilderX 和 Cursor 之间切换的开发者提供了便利。

安装前提条件

在使用此插件之前，请确保您的系统已满足以下条件：

1. 安装 Cursor 编辑器

• 访问 Cursor 官网 下载并安装 Cursor 编辑器
• 确保 Cursor 已正确安装并可以正常启动

2. 配置 Cursor 命令行工具

• 打开 Cursor 编辑器
• 使用快捷键 Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows/Linux) 打开命令面板
• 输入 "Shell Command: Install 'cursor' command in PATH"
• 选择该命令并执行，这将安装 cursor 命令行工具

3. 验证 cursor 命令是否可用

在终端中运行以下命令验证：

cursor --version

如果显示版本信息，说明安装成功。

插件功能

• 快速切换编辑器：从 HBuilderX 快速切换到 Cursor
• 精确定位：自动定位到当前光标所在的行号和列号
• 右键菜单集成：在编辑器中右键即可使用

使用方法

方法一：右键菜单

1. 在 HBuilderX 中打开任意文件
2. 将光标移动到您想要在 Cursor 中查看的位置
3. 在编辑器中右键点击
4. 选择 "Open in Cursor" 选项
5. 插件将自动在 Cursor 中打开该文件并定位到指定位置

工作原理

插件会执行以下操作：

1. 获取当前编辑器的文件路径
2. 获取光标所在的行号和列号
3. 使用 cursor -g "文件路径:行号:列号" 命令在 Cursor 中打开文件
4. Cursor 将自动定位到指定的行和列位置

故障排除

问题：cursor 命令未找到

解决方案：

1. 确保已正确安装 Cursor 编辑器
2. 在 Cursor 中执行 "Shell Command: Install 'cursor' command in PATH"
3. 重启终端或 HBuilderX
4. 在终端中验证：cursor --version

问题：插件无法打开 Cursor

解决方案：

1. 检查 Cursor 是否正确安装
2. 确认 cursor 命令是否在系统 PATH 中
3. 尝试在终端中手动运行：cursor -g "文件路径:1:1"

问题：光标位置定位不准确

解决方案：

1. 确保光标在文本区域内
2. 检查文件是否保存（未保存的文件可能影响定位）
3. 重启 HBuilderX 和 Cursor

系统要求

• 操作系统：Windows 10+, macOS 10.14+, Linux
• HBuilderX 版本：2.7.0 或更高版本
• Cursor 版本：最新版本
• Node.js：插件运行环境（通常随 HBuilderX 提供）

版本信息

• 当前版本：0.0.1
• 发布者：houengineer@qq.com
• 兼容性：HBuilderX 2.7.0+

技术支持

如果您在使用过程中遇到问题，请：

1. 检查上述故障排除部分
2. 确认系统环境是否满足要求
3. 查看 HBuilderX 控制台输出的错误信息

注意：此插件需要 Cursor 编辑器已安装并配置好命令行工具才能正常工作。