Folder Tagger (文件夹标签)
GitHub 仓库 •
VS Code 市场
⭐ 如果觉得这个扩展对你有帮助，请给我们一个 Star 支持！
Folder Tagger 是一款专为 VS Code 设计的高性能文件与文件夹标签管理扩展，旨在帮助开发者在复杂项目中快速组织和定位资源。通过直观的可视化界面和强大的标签管理功能，显著提升大型项目的导航效率和代码组织体验。
🚀 核心特性
1. 双视图管理系统
- 标签树视图：以树状结构展示工作区文件，实时同步标签显示，支持过滤未标记项，专注于关键资源。
- 标签汇总视图：按标签名称聚合资源，点击标签可展开并跳转至对应文件，便于跨模块快速切换。
2. 智能自动同步
- 编辑器联动：当在编辑器中切换文件时，自动在侧边栏选中并滚动到对应节点。
- 视图激活同步：视图展开时自动定位到当前活动文件，无需手动导航。
3. 视觉增强标记
- 徽章标识：已标记资源自动显示
T 徽章，一目了然。
- 主题色渲染：标签文本以主题强调色显示在文件名右侧，增强视觉识别。
4. 灵活的显示控制
- 隐藏未标记项：通过标题栏的"眼睛"图标切换，一键过滤未标记文件，创建"精选视图"。
- 状态持久化：显示偏好存储在工作区状态中，重启窗口后保持不变。
5. 企业级可靠性
- 高性能架构：采用内存缓存 + 防抖写盘 (500ms) 机制，支持数万级文件的毫秒级响应。
- 协作友好：标签存储于
.vscode/folder-tagger-tags.json，可通过 Git 同步，支持团队协作。
- 路径自动追踪：自动处理文件重命名、移动或删除，保持标签映射的准确性。
📦 安装与配置
- 从 VS Code 扩展市场安装：搜索 "Folder Tagger" 并安装。
- 手动安装：下载
.vsix 文件，在 VS Code 中使用 "从 VSIX 安装" 功能。
🛠 使用指南
添加/修改标签
- 方法一：鼠标悬浮在文件上，点击行内的
修改标签 图标。
- 方法二：在资源管理器中右键点击文件，选择
修改标签。
- 在输入框中输入标签，支持使用逗号、分号或空格分隔（例如：
UI, 核心逻辑, 待修复）。
快速定位
- 在原生资源管理器中右键点击文件，选择
在标签树中显示。
- 在标签树中点击
在资源管理器中显示 图标，跳回原生视图。
管理标签
- 移除标签：再次触发 "修改标签" 命令，清空输入框并确认。
- 刷新数据：点击视图标题栏的刷新图标，强制从磁盘重载标签数据。
📁 数据存储
所有标签数据以 JSON 格式存储在项目根目录：
- 路径：
.vscode/folder-tagger-tags.json
- 格式：键为相对路径，值为标签数组。
{
"src/components/Button.tsx": ["UI", "重构中"],
"src/api/auth.ts": ["后端校验"]
}
🛠 开发与贡献
- 克隆仓库：
git clone <repository-url>
- 安装依赖：
npm install
- 开发调试：按下
F5 启动扩展开发宿主。
- 实时编译：运行
npm run watch 保持 TypeScript 代码自动编译。
- 打包发布：
- 生成
.vsix 文件：npx @vscode/vsce package
- 发布到扩展市场：
npx @vscode/vsce publish
🌍 国际化支持
📄 许可证
MIT License
🤝 贡献
欢迎提交 Issue 和 Pull Request，共同改进 Folder Tagger 扩展！
Folder Tagger - 让你的项目组织更高效，导航更便捷。
| |
