GoLand Opener

一个 Cursor 编辑器插件，用于快速在 GoLand 中打开当前文件，并定位到光标位置。

功能特性

• 使用快捷键（默认 Ctrl+Alt+G）快速在 GoLand 中打开当前文件
• 自动定位到 Cursor 中光标所在的行和列
• 支持自定义 GoLand 安装路径
• 支持 Windows、macOS 和 Linux

使用方法

1. 在 Cursor 中打开任意文件
2. 使用以下任一方式打开 GoLand：
   • 按下快捷键 Ctrl+Alt+G（Windows/Linux）或 Cmd+Alt+G（macOS）
   • 打开命令面板（Ctrl+Shift+P），输入"在 GoLand 中打开"

配置指南

配置 GoLand 路径

方式一：通过设置界面（推荐）

1. 打开设置（Ctrl+,）
2. 搜索 "goland opener"
3. 找到 goland-opener.golandPath 设置项
4. 输入 GoLand 可执行文件的完整路径

方式二：编辑 settings.json

1. 打开命令面板（Ctrl+Shift+P）
2. 输入并选择 "Preferences: Open Settings (JSON)"
3. 添加以下配置：

{
    "goland-opener.golandPath": "C:\\Program Files\\JetBrains\\GoLand 2024.3.3\\bin\\goland64.exe"
}

默认安装路径

如果未配置自定义路径，插件将使用以下默认路径：

• Windows: C:\Program Files\JetBrains\GoLand 2024.3.3\bin\goland64.exe
• macOS: /Applications/GoLand.app/Contents/MacOS/goland
• Linux: /opt/goland/bin/goland.sh

查找 GoLand 安装路径

• Windows

  1. 右键点击 GoLand 快捷方式
  2. 选择"属性"
  3. 查看"目标"字段中的完整路径

• macOS

  • 标准安装路径：/Applications/GoLand.app/Contents/MacOS/goland

• Linux

  • 使用命令：which goland
  • 或查看：/opt/goland/bin/goland.sh

自定义快捷键

方式一：通过设置界面

1. 打开设置（Ctrl+,）
2. 搜索 "goland opener"
3. 找到 goland-opener.keyboardShortcut 设置项
4. 输入新的快捷键组合

方式二：编辑 settings.json

{
    "goland-opener.keyboardShortcut": "ctrl+alt+g"
}

常见问题

找不到 GoLand

• 检查 GoLand 安装路径是否正确
• Windows 路径使用双反斜杠 \\ 或单正斜杠 /
• 确保有权限访问 GoLand 可执行文件

快捷键不生效

• 检查是否与其他插件的快捷键冲突
• 重新加载 Cursor 编辑器
• 确认当前窗口有焦点（编辑器处于活动状态）

路径中包含空格

• 无需手动添加引号，插件会自动处理路径

注意事项

1. 修改任何配置后，需要重新加载 Cursor 编辑器
2. 确保配置的路径指向 GoLand 的可执行文件（.exe/.sh）
3. 如果遇到问题，请查看 Cursor 的输出面板中的错误信息

开发相关

构建插件

npm install    # 安装依赖
npm run compile    # 编译插件
npm run package    # 打包插件

发布插件

准备工作

1. 确保 package.json 中的信息完整：

   {
     "name": "goland-opener",
     "displayName": "GoLand Opener",
     "description": "在 GoLand 中打开当前文件并定位到光标位置",
     "version": "1.0.0",
     "publisher": "你的发布者名称",
     "repository": {
       "type": "git",
       "url": "https://github.com/你的用户名/goland-opener"
     }
   }
   

2. 准备必要文件：

   • README.md（插件说明文档）
   • LICENSE（MIT 许可证）
   • CHANGELOG.md（版本更新日志）
   • 插件图标（可选）

发布步骤

1. 注册 Cursor 开发者账号

   • 访问 Cursor 开发者门户
   • 创建开发者账号
   • 获取发布令牌（Token）

2. 安装 Cursor 发布工具

   npm install -g @cursor/vsce
   

3. 登录发布工具

   vsce login <发布者名称>
   

4. 打包插件

   vsce package
   

   这将生成一个 .vsix 文件

5. 发布插件

   vsce publish
   

更新插件

1. 更新版本号

   npm version patch  # 小版本更新
   # 或
   npm version minor  # 功能更新
   # 或
   npm version major  # 重大更新
   

2. 更新 CHANGELOG.md

   ## [1.0.1] - 2024-03-xx
   ### 修复
   - 修复了xxx问题
   ### 新增
   - 添加了xxx功能
   

3. 重新发布

   vsce publish
   

发布注意事项

1. 确保代码质量

   • 运行测试用例
   • 检查代码风格
   • 测试所有功能

2. 文档完善

   • README.md 内容详尽
   • 包含使用示例
   • 清晰的安装说明
   • 完整的配置说明

3. 版本控制

   • 遵循语义化版本规范
   • 记录详细的更新日志
   • 为每个版本打标签

4. 市场展示

   • 添加清晰的功能截图
   • 编写简洁的功能描述
   • 列出主要特性
   • 提供示例配置

许可证

MIT