Code Navigator - Java代码书签导航插件
一个专为Java开发者设计的VSCode书签管理和快速导航插件，让你能够轻松管理和跳转到重要的代码位置。
✨ 主要功能
📌 智能书签管理
- 三种书签类型：纯文本书签、类级别书签、方法级别书签
- 右键添加：在Java代码中右键即可快速添加书签
- 智能识别：自动识别当前位置的类名和方法名
- 树形展示：左侧面板以树形结构展示所有书签
🎯 精准跳转导航
- 一键跳转：点击书签直接跳转到对应代码位置
- 多匹配选择：当有多个匹配项时显示选择列表
- 跨文件搜索：基于类名和方法名全局搜索，不依赖文件路径
- 环境无关：换电脑、换项目路径都能正常使用
🔧 强大的管理功能
- 完整CRUD：新增、编辑、删除、搜索书签
- 拖拽排序：支持拖拽重新组织书签结构
- 层级管理：支持添加下级书签，形成层级结构
- 批量操作：导入导出书签数据
📦 安装方法
从VSCode扩展商店安装（推荐）
- 打开VSCode
- 按
Ctrl+Shift+X打开扩展面板
- 搜索"Code Navigator"
- 点击安装
手动安装
- 下载
.vsix文件
- 打开VSCode命令面板（
Ctrl+Shift+P）
- 输入"Extensions: Install from VSIX"
- 选择下载的文件
🚀 快速开始
1. 添加书签
- 打开任意Java文件
- 在想要标记的位置右键
- 选择"📌 添加到书签"
- 按提示填写书签信息
2. 使用书签
- 跳转：在左侧"Code Navigator"面板中点击书签
- 编辑：右键书签选择"✏️ 编辑书签"
- 删除：右键书签选择"🗑️ 删除书签"
- 搜索：点击面板顶部的搜索框
📖 详细使用指南
书签类型说明
📝 纯文本书签
- 用途：记录想法、备注、待办事项
- 特点：不需要类名，无跳转功能
- 适用场景：代码注释、重构提醒、问题记录
🏷️ 类级别书签
- 用途：标记重要的类
- 特点：只需要类名，跳转到类定义
- 适用场景：核心业务类、配置类、工具类
🔧 方法级别书签
- 用途：标记重要的方法
- 特点：需要类名和方法名，跳转到方法定义
- 适用场景：关键业务逻辑、复杂算法、接口方法
常用操作
添加书签
右键菜单 → 📌 添加到书签 → 填写信息 → 确认保存
编辑书签
书签面板 → 右键书签 → ✏️ 编辑书签 → 修改信息 → 确认保存
层级管理
书签面板 → 右键父书签 → ➕ 添加下级书签
排序和移动
书签面板 → 右键书签 → ⬆️ 上移 / ⬇️ 下移
书签面板 → 拖拽书签到目标位置
搜索过滤
书签面板 → 点击 🔍 搜索书签 → 输入关键词
⚙️ 配置选项
在VSCode设置中搜索"Code Navigator"可以找到以下配置：
codeNavigator.maxBookmarks: 最大书签数量（默认100）codeNavigator.autoCleanInvalid: 自动清理无效书签（默认true）codeNavigator.showFilePathInTooltip: 悬浮提示中显示文件路径（默认true）codeNavigator.enableFuzzySearch: 启用模糊搜索（默认true）
🎯 使用技巧
1. 智能挂接
选中左侧面板中的书签后添加新书签，新书签会自动成为选中书签的子书签。
2. 批量管理
使用导出/导入功能可以在不同工作区间同步书签，或者备份重要的书签数据。
3. 搜索技巧
搜索功能支持匹配书签名称、类名、方法名，可以快速找到目标书签。
4. 拖拽重组
通过拖拽可以轻松重新组织书签结构，将相关书签归类到一起。
🔍 故障排除
跳转失败
- 确认类名和方法名拼写正确
- 检查目标代码文件是否在当前工作区
- 查看开发者工具控制台的错误信息
书签丢失
- 书签数据保存在VSCode的全局状态中
- 可以使用导出功能备份重要书签
- 重装插件不会丢失书签数据
性能问题
- 大型项目建议限制书签数量
- 可以关闭自动清理功能提升性能
- 使用搜索功能快速定位书签
🤝 反馈与支持
📋 系统要求
- VSCode 1.60.0 或更高版本
- 支持Java语言文件
- 推荐使用Java扩展包以获得更好的体验
📄 许可证
本项目基于 MIT License 开源协议。
享受更高效的Java代码导航体验！ 🚀
| |
