# beetlsql-idea-support

**Repository Path**: eighttrigrams/beetlsql-idea-support

## Basic Information

- **Project Name**: beetlsql-idea-support
- **Description**: beetlsql idea 插件
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 6
- **Created**: 2020-09-08
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 插件说明

从插件市场搜索`beetlsql-support`或者直接本地安装`plugin/beetlsql-support.jar`
插件功能
* mapper的方法和 markdown文件的sql片段相互定位
* markdown文件的sql支持语法和beetl方法提示，支持mapper方法中变量名字提示
* 支持maven工程，不支持gradle


## 插件开发

使用idea 2025社区版本打开此工程，idea插件使用gradle构建. 你需要熟悉gradle用法，以及设置镜像仓库
* 确保~/.gradle 目录下init.gradle设置的maven仓库指向国内镜像
```gradle
allprojects {  
    repositories {  
         maven {  
             name "aliyunmaven-1" 
             url "https://maven.aliyun.com/nexus/content/groups/public/"  
         }  
    } 
} 

```
* 本工程的gradle-wrapper.properties和settings.gradle.kts 都已经添加了镜像
* 在导入工程时候，idea依据`build.gradle.kts` 中的 目标idea，会下载此版本idea作为调试运行沙箱，需要较长时间
* 当gradle 面板显示beetlsql-support 后，说明工程导入成功，可以运行intellj platorm |  runIde



## Release 
- 1.2.1
  1. 支持idea-2025
  2. beetelsql2 不再支持
  3. markdown语法提示增加了if 和 for
  
- 1.1.0 
  1. 修复IDEA 插件开发的API兼容性问题，以长期支持idea-2023.1及以上版本，更低版本不再支持
  2. idea插件市场不太让id包括intellij单词，所以改了下插件id，所以可能会导致插件市场存在两个插件，请选择此1.1.0版本
  3. 优化了跳转和代码完成
  
  4. 问题：一个项目的多个模块能使用不同的BeetlSql版本嘛。
        > 答：不能，因为不好处理每个模块该读取哪个btl-ext.properties。
     而且在maven的依赖树中，作为一个基础模块可以被多个模块引入，这时候基础模块一般没有beetlsql依赖，这就导致不知道这个模块用哪个版本.

  5. 问题：为什么没有出现跳转？
        > 答：如果没有出现跳转的图标，请重新打开文件或者重新打开项目。
    这是因为插件的运行依赖idea查找maven依赖，这要求项目必须加载完成后才能进行。
    而且由于idea对读取的限制，这些操作都是在idea内置的一种专门执行读取操作的线程，所以在项目刚打开时是存在延迟的。

## idea插件开发文档

* 例子 https://plugins.jetbrains.com/docs/intellij/code-samples.html
* 官方文档  https://plugins.jetbrains.com/docs/intellij/welcome.html
*