# 枸杞VBE插件

**Repository Path**: danter/Gouqi_VBE_Addin

## Basic Information

- **Project Name**: 枸杞VBE插件
- **Description**: Visual Basic Editor Addin
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-09-15
- **Last Updated**: 2025-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 枸杞VBE插件

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![.NET Framework](https://img.shields.io/badge/.NET%20Framework-4.7.2-blue.svg)](https://dotnet.microsoft.com/download/dotnet-framework)

一个功能强大的Microsoft Office VBA编辑器（VBE）增强插件，旨在提升VBA开发者的编程效率和体验。

## 📋 项目简介

枸杞VBE插件是一个专为VBA开发者设计的COM加载项，通过扩展VBE的功能，提供代码片段管理、代码格式化、工程密码破解等实用工具，显著提升VBA开发效率。

## ✨ 主要功能

### 🗂️ 代码库管理
- **智能代码片段存储**：支持语句、函数、模块、类模块等多种代码类型
- **层级化组织**：树形结构管理代码片段，支持分类和嵌套
- **快速插入**：一键将代码片段插入到当前编辑位置
- **可视化管理界面**：直观的代码库窗体，支持增删改查操作
- **数据持久化**：使用LiteDB轻量级数据库安全存储

### 🎨 代码格式化
- **智能格式化引擎**：内置VB代码格式化器
- **灵活格式化选项**：支持格式化当前模块或当前过程
- **代码美化**：自动缩进、对齐和代码结构优化
- **批量处理**：支持批量格式化多个模块

### 🔧 VBE增强工具
- **删除空行**：快速清理代码中的多余空行
- **工程密码破解**：绕过VBA工程的密码保护限制
- **自定义工具栏**：在VBE中添加专属的"枸杞VBE工具栏"
- **右键菜单扩展**：增强代码编辑器的右键菜单功能
- **快捷键支持**：自定义键盘快捷键提升操作效率

### ⚙️ 个性化配置
- **配置管理**：提供配置窗体进行个性化设置
- **菜单定制**：支持动态菜单生成和自定义
- **界面适配**：与VBE界面无缝集成

## 🛠️ 技术架构

- **开发语言**：C# (.NET Framework 4.7.2)
- **COM互操作**：深度集成VBE，提供原生体验
- **NetOffice API**：使用NetOffice库确保跨版本兼容性
- **数据存储**：LiteDB轻量级嵌入式数据库
- **Windows API**：通过P/Invoke实现系统级功能
- **AOP编程**：使用Rougamo框架进行面向切面编程

## 📦 安装说明

### 系统要求
- Windows 7/8/10/11
- Microsoft Office 2010 或更高版本
- .NET Framework 4.7.2 或更高版本

### 安装步骤

1. **下载插件**
   ```
   从Releases页面下载最新版本的安装包
   ```

2. **运行安装程序**
   ```
   双击运行下载的安装包，按照向导完成安装
   ```

3. **启用插件**
   - 打开任意Office应用程序（Excel、Word、PowerPoint等）
   - 按 `Alt + F11` 打开VBE
   - 在VBE中选择 `工具` → `COM加载项`
   - 勾选"枸杞VBE插件"并确定

4. **验证安装**
   - 重启VBE后应该能看到"枸杞VBE工具栏"
   - 右键菜单中应该出现新的功能选项

## 🚀 使用指南

### 代码库管理
1. **打开代码库**：点击工具栏中的"代码库"按钮
2. **添加代码片段**：
   - 右键选择"收藏语句/函数/模块"
   - 或手动创建新的代码分类
3. **使用代码片段**：在菜单中选择对应的代码片段即可自动插入

### 代码格式化
1. **格式化当前模块**：右键菜单选择"格式化当前模块"
2. **格式化当前过程**：将光标置于过程内，选择对应菜单项

### 工程密码破解
1. **启用功能**：工具栏选择"无视工程密码"
2. **访问受保护工程**：现在可以查看和编辑受密码保护的VBA工程
3. **恢复保护**：使用"恢复密码"功能重新启用密码保护

## 📁 项目结构

```
Gouqi_VBE_Addin/
├── 枸杞.插件.VBE插件/          # 主插件项目
│   ├── 代码库/                 # 代码库管理模块
│   ├── 代码格式化/             # 代码格式化引擎
│   ├── 窗体/                   # 用户界面窗体
│   ├── 资源文件/               # 图标等资源
│   └── *.cs                    # 核心功能类
├── 枸杞VBE插件.Core/          # 核心库项目
└── VBE打包模版.iss            # 安装包制作脚本
```

## 🤝 贡献指南

欢迎提交Issue和Pull Request来帮助改进这个项目！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🙏 致谢

- 感谢 [NetOffice](https://github.com/NetOfficeFw/NetOffice) 项目提供的Office互操作库
- 感谢 [LiteDB](https://github.com/mbdavid/LiteDB) 项目提供的轻量级数据库解决方案

## 📞 联系方式

如果您有任何问题或建议，请通过以下方式联系：

- 提交 [Issue](../../issues)
- 发起 [Discussion](../../discussions)

---

⭐ 如果这个项目对您有帮助，请给它一个星标！