ide-eval-resetter 使用与原理完全指南:一键重置 JetBrains IDE 评估期
ide-eval-resetter 使用与原理完全指南:一键重置 JetBrains IDE 评估期
本文以仓库 README.md 为骨架,围绕 JetBrains 系 IDE 评估期(Eval)重置这一核心主题展开:先给出插件方式"四步重置"的完整实操流程,再深入 ResetAction.java 源码剖析一次重置究竟清理了哪些本地状态文件,随后讲解
reset_eval目录下 macOS/Linux/Windows 三种脚本备选方案,最后介绍插件内置的"25 天自动提醒"长效机制。读完你既能照做重置,也能彻底理解其底层原理。
一、项目概览:它解决什么问题
JetBrains 家族的 IntelliJ IDEA、PyCharm、CLion、GoLand、PhpStorm、WebStorm、Rider、DataGrip、RubyMine、AppCode 等 IDE 默认提供 30 天免费评估期。评估期的起止状态并非只存在服务器端,更多是保存在本机的多个位置:IDE 配置目录下的 eval 目录、options/other.xml 中的 evlsprt 记录、Java Preferences 里的机器标识,以及 Windows 平台上的共享设备文件。
ide-eval-resetter 正是针对这套本地评估状态而设计的开源工具,它提供两种重置途径:
- IntelliJ Platform 插件:安装后在菜单中点一下即可完成清理并自动重启,是最"图形化"的方式;
- 独立脚本:仓库 reset_eval 目录下提供 macOS/Linux Shell 脚本与 Windows VBS 脚本,无需安装任何插件,适合批量或自动化场景。
从工程结构看,本仓库是一个基于 Gradle Wrapper 的 Java 工程,settings.gradle 定义了工程名为 ide-eval-resetter,插件核心源码集中在 src/main/java/io/zhile/research/intellij 包下(MainComponent.java、ResetAction.java、Constants.java、NotificationHelper.java),Gradle Wrapper 版本为 6.1.1(见 gradle/wrapper/gradle-wrapper.properties)。
二、插件方式:四步完成评估期重置
README.md 给出的插件使用流程非常简洁,核心只有四步,下面逐条展开并结合源码解释其背后动作。
步骤 1:从 Release Page 下载并安装插件
从项目的 Release 页面下载最新版本的插件安装包。在 IntelliJ 系 IDE 中通过 Settings / Preferences -> Plugins -> Install Plugin from Disk... 选择下载的安装包即可完成安装(README 原文给出的发布链接指向项目 Release 页面)。
安装后插件会作为 ApplicationComponent 常驻运行。从 MainComponent.java 的 initComponent() 可以看到,插件在启动 3 秒后会读取上次重置时间,并通过气泡通知展示;插件名与产品名分别来自 Constants.java 中 PluginManager.getPlugin(PLUGIN_ID).getName() 与 ApplicationNamesInfo.getInstance().getFullProductName(),通知则统一走 NotificationHelper.java 封装的 NotificationGroup。
步骤 2:点击 Help(或 Get Help)-> Reset IDE Eval 菜单
重置动作被注册为一个 AnAction。在 ResetAction.java 的构造函数中,菜单项标题被动态生成为 "Reset " + Constants.PRODUCT_NAME + "'s Eval",例如在 IntelliJ IDEA 中即显示为 Reset IntelliJ IDEA's Eval(README 中简称为 Reset IDE Eval),描述文本为 "Reset my IDE eval information",并配以 AllIcons.General.Reset 图标。
点击菜单后,actionPerformed() 会按顺序完成一整串清理动作(详见下一节),最后弹出 "Reset successfully! Please restart your IDE and enjoy it!" 的通知,并自动触发 IDE 重启。
步骤 3:重启 IDE
重置动作执行完毕后,插件会调用 ApplicationManager.getApplication().restart() 自动重启 IDE(见 ResetAction.java)。若自动重启因故未生效,手动重启一次同样可以完成收尾。
步骤 4:再次获得 30 天评估期
重启后,IDE 重新读取本地状态时会认为这是一台"全新"设备,从而再次给出完整的 30 天评估期。这正是 README 中 "Now you have another 30 days eval time" 的含义——重置的本质是清除本地评估记录,而非绕过授权验证。
三、源码级解析:一次重置到底清理了什么
ResetAction.java 是理解整个工具工作原理的关键文件,actionPerformed() 的执行顺序如下。
3.1 删除评估目录 eval
File evalFile = getEvalFile();
if (evalFile.exists()) {
if (!FileUtil.delete(evalFile)) {
NotificationHelper.showError(project, "Remove eval folder failed!");
return;
}
}
getEvalFile()(ResetAction.java)返回 PathManager.getConfigPath() 下的 eval 目录,即 IDE 配置根目录中的评估状态文件夹。删除失败会直接弹出 "Remove eval folder failed!" 错误通知并中止后续流程。
3.2 从 options/other.xml 过滤 evlsprt 记录
eval 目录之外,options/other.xml 中还会写入一系列以 evlsprt 开头的属性记录。getOptionsFile()(ResetAction.java)定位到 <config>/options/other.xml,随后逐行扫描并删除所有包含 name="evlsprt 的行,再将剩余内容写回文件:
while (scanner.hasNextLine()) {
String line = scanner.nextLine();
if (!line.contains("name=\"evlsprt")) {
sbContent.append(line).append("\n");
}
}
之所以精确匹配 evlsprt 前缀,是为了只清除评估期相关记录,不动 other.xml 中的其他 IDE 配置。
3.3 清除 Java Preferences 中的机器标识
这是最关键的一步。JetBrains IDE 会把机器/设备标识写入 Java Preferences(Java 内置的键值存储),用于识别"是否同一台机器"。ResetAction 定义了三个待清除的键(ResetAction.java):
| 常量 | 键名 | 所在节点 | 作用 |
|---|---|---|---|
OLD_MACHINE_ID_KEY |
JetBrains.UserIdOnMachine |
Preferences.userRoot()(根节点) |
旧版机器用户标识 |
NEW_MACHINE_ID_KEY |
user_id_on_machine |
厂商名节点 | 新版机器用户标识 |
DEVICE_ID_KEY |
device_id |
厂商名节点 | 设备标识 |
厂商名节点取自 ApplicationInfoImpl.getShadowInstance().getShortCompanyName(),若为空则回退为默认值 jetbrains(ResetAction.java)。随后依次执行:
prefsRoot.remove(OLD_MACHINE_ID_KEY);
prefs.remove(NEW_MACHINE_ID_KEY);
prefs.remove(DEVICE_ID_KEY);
3.4 Windows 平台附加清理:共享设备文件
当 appInfo.isVendorJetBrains() 且系统为 Windows 时,还会额外删除 %APPDATA%\JetBrains 下的两个共享设备文件(ResetAction.java):
PermanentUserId(永久用户 ID)PermanentDeviceId(永久设备 ID)
删除任一失败都会提示 "Remove xxx file failed!" 并中止。
3.5 记录重置时间并自动重启
清理全部完成后,插件会把本次重置时间写入 Preferences.userRoot().node(Constants.PLUGIN_NAME) 节点,键名为 产品名 + 配置路径哈希(ResetAction.java)。这条时间记录正是第五节"自动提醒机制"判断何时再次提醒的依据。最后弹出成功通知并自动重启:
NotificationHelper.showInfo(project, "Reset successfully!\nPlease restart your IDE and enjoy it!");
ApplicationManager.getApplication().invokeLater(() -> ApplicationManager.getApplication().restart());
四、备选方案:无需安装插件的重置脚本
README 明确指出另一种途径:直接运行 reset_eval 目录下的脚本。该目录包含两个脚本,分别覆盖 macOS/Linux 与 Windows,脚本头部标注版本 v1.0.4。
4.1 macOS / Linux:reset_jetbrains_eval_mac_linux.sh
reset_jetbrains_eval_mac_linux.sh 是一个纯 Bash 脚本,先通过 uname -s 判断系统,再针对一组 JetBrains 产品目录批量清理:
JB_PRODUCTS="IntelliJIdea CLion PhpStorm GoLand PyCharm WebStorm Rider DataGrip RubyMine AppCode"
macOS 分支(Darwin)执行的动作包括:
- 删除
~/Library/Preferences/<产品>*/eval与~/Library/Application Support/JetBrains/<产品>*/eval评估目录; - 用
sed -i '' '/name="evlsprt.*"/d'从对应的options/other.xml中删除evlsprt记录; - 用
plutil -remove从~/Library/Preferences/com.apple.java.util.prefs.plist中移除/.JetBrains\.UserIdOnMachine、/.jetbrains/.user_id_on_machine、/.jetbrains/.device_id三个键(对应 3.3 节中的三个 Java Preferences 标识)。
Linux 分支 的动作与之对应:
- 删除
~/.<产品>*/config/eval与~/.config/JetBrains/<产品>*/eval; - 用
sed -i清理对应options/other.xml中的evlsprt行; - 用
sed -i '/key="..."/d'清理~/.java/.userPrefs/prefs.xml(旧键JetBrains.UserIdOnMachine)与~/.java/.userPrefs/jetbrains/prefs.xml(device_id、user_id_on_machine)中的相关键。
脚本对不支持的平台会输出 unsupport 并直接退出,正常结束时打印 done.。可以看到,脚本与插件 ResetAction 清理的对象完全一致:eval 目录、other.xml 的 evlsprt 行、Java Preferences 的三个机器标识,只是实现方式从 Java 换成了 Shell 命令。
4.2 Windows:reset_jetbrains_eval_windows.vbs
reset_jetbrains_eval_windows.vbs 基于 WScript.Shell 与 Scripting.FileSystemObject 实现。它先用正则 \.?(IntelliJIdea|GoLand|CLion|PyCharm|DataGrip|RubyMine|AppCode|PhpStorm|WebStorm|Rider).* 匹配 JetBrains 产品目录名,然后:
- 遍历
%USERPROFILE%下的产品目录,删除<产品>\config\eval,并过滤对应options\other.xml中所有包含name="evlsprt"的行; - 遍历
%APPDATA%\JetBrains下的产品目录,删除<产品>\eval并同样清理other.xml; - 删除三个注册表键(对应 Java Preferences):
HKEY_CURRENT_USER\Software\JavaSoft\Prefs\/Jet/Brains./User/Id/On/Machine、jetbrains\device_id、jetbrains\user_id_on_machine; - 删除
%APPDATA%\JetBrains下的bl、crl、PermanentUserId、PermanentDeviceId共享文件(与插件 3.4 节的 Windows 附加清理一致); - 最后弹窗提示
done。
使用方式:在 Windows 上直接双击或通过命令行 cscript reset_jetbrains_eval_windows.vbs 运行即可。
五、长效提醒机制:距上次重置超过 25 天自动提示
除了手动重置,插件还内置了一个"到期前提醒"机制,实现集中在 MainComponent.java。
5.1 启动时展示上次重置时间
initComponent() 在 IDE 启动 3 秒后执行:读取上次重置时间戳(0 表示从未重置过),若大于 0 则以 yyyy-MM-dd HH:mm:ss 格式弹出 "The last reset time: ..." 气泡通知(MainComponent.java)。
5.2 每 60 分钟检查一次"是否已超 25 天"
ResetTimerTask 的核心逻辑是:
private static final long RESET_PERIOD = 2160000000L; // 25 days
if (System.currentTimeMillis() - lastResetTime > RESET_PERIOD) {
// 弹出提醒通知,并附带一个 ResetAction 按钮,点击即可再次重置
}
new Timer().schedule(new ResetTimerTask(lastResetTime), 3600000); // 60 min
关键设计在于:RESET_PERIOD 被设为 25 天(2160000000 毫秒),短于 30 天的评估期本身。也就是说,从上次重置起算 25 天后,插件就会开始每 60 分钟检查一次并弹出 "It has been a long time since the last reset! Would you like to reset it again?" 提醒,通知自带 ResetAction 按钮可直接再次重置——这样用户无需盯着日历,也不会因为忘记重置而耗尽评估期。这是源码层面可以确认的默认行为(MainComponent.java)。
六、源码结构与工程组织速览
仓库的插件源码只有四个 Java 类,职责非常清晰:
| 文件 | 职责 |
|---|---|
| MainComponent.java | ApplicationComponent 入口,负责启动初始化、展示上次重置时间、25 天周期自动提醒 |
| action/ResetAction.java | 核心 AnAction,实现全部清理逻辑、重置时间记录与自动重启 |
| helper/Constants.java | 插件 ID/名称、产品名称、配置路径哈希等常量 |
| helper/NotificationHelper.java | 统一封装气泡通知(Info/Warn/Error 三级) |
工程本身通过 Gradle Wrapper 构建(根目录 gradlew、gradlew.bat),settings.gradle 仅声明工程名 ide-eval-resetter,Gradle 版本为 6.1.1。仓库以 GPL v2 协议开源(见 LICENSE)。
七、适用前提与注意事项
- 重置对象是本地评估状态:本工具清除的是本机保存的 eval 目录、
other.xml中的evlsprt记录、Java Preferences 机器标识与平台共享设备文件,不涉及激活码、账号或服务器端授权,只影响"评估期"这一本地记录。 - 操作具有破坏性:脚本与插件都会删除文件和修改配置文件(Shell 脚本中使用了
rm -rf、sed -i等命令,VBS 脚本会删除文件夹并改写other.xml),执行前建议先备份 IDE 配置;误删可能导致 IDE 设置丢失。 - 路径随产品与版本变化:脚本按
IntelliJIdea*、PyCharm*等通配符匹配产品目录,不同 JetBrains 产品、不同版本目录命名可能存在差异,脚本覆盖的产品列表以JB_PRODUCTS变量为准。 - 周期说明:README 明确每次重置后可再次获得 30 天评估期;插件内置的自动提醒周期为 25 天,早于 30 天到期时间,属于源码中硬编码的默认行为(
RESET_PERIOD = 2160000000L)。 - 适用平台:插件方式适用于 IntelliJ Platform 系 IDE;脚本方式分别覆盖 macOS(Darwin)、Linux 与 Windows,其余平台脚本会输出
unsupport并退出。
总而言之,无论走插件菜单还是直接运行脚本,ide-eval-resetter 的"一键重置"背后都是一套清晰、可复现的本地状态清理流程:删 eval 目录、滤 evlsprt 行、清机器标识、删平台共享文件,再配合 25 天自动提醒,让 JetBrains IDE 的 30 天评估期可以按需持续循环使用。