相关说明

    Halo 项目使用了 Lombok,运行 Halo 之前请检查 IDE 是否已经安装好了 Lombok 插件。

    如果使用的 IDEIntelliJ IDEA,请在设置中启用 Build, Execution, Deployment/Annotation ProcessorsEnable annotation processing

    如果仍然因为 Lombok 报错,请更新 IntelliJ IDEA 至最新版。

    如果你已经 forkHalo,请将以下命令中的 halo-dev 替换为你的 Github 用户名

    这里推荐使用第二种方式进行克隆,这样每次提交代码的时候,就不会提示登录 Github 了。

    导入项目的时候请选择 Gradle 项目进行导入。

    如果需要指定配置,请在 内进行设置 VM options(这里推荐采用上文的),例如:

    1. -Dspring.profiles.active=dev
    2. -Dhalo.auth-enabled=false
    3. -Dhalo.production-env=false

    在项目根目录下运行以下命令:

    如果需要手动指定配置,可添加 —args 参数(这里推荐采用上文的自定义配置),例如:

    1. # 类 Unix 用户
    2. # Windows 用户
    3. ./gradlew.bat bootRun --args="--spring.profiles.active=dev --server.port=2333"

    如果一切正常且没有额外指定配置,则可根据控制台的输出链接进行访问 Halo

    首次运行的时候,会跳转到博客安装页面,请大家耐心填写完毕,最后正式进入开发之旅

    这里推荐一个配置:


    运行命令中添加 VM options,例如:

    1. -Dspring.profiles.active=dev

    IDE 一般都会提供一个 Run/Debug 配置,可以添加 VM options参数。以上示例可以直接应用在以命令运行方式上。

    在开发环境下,修改代码之后,每次都需要重启应用,是一个非常耗时的操作。

    有一个专门解决这个问题的工具,那就是 ,但是它的费用实在是太昂贵,作为普通的开发者很难承受这笔费用(但不推荐使用破解版)。

    于是 Halo 最后采用了 Spring Boot 官方推荐的 Developer Tools

    这里以 为例。

    • 进入 Settings (Preferences on macOS)。
    • 打开 Build, Execution, Deployment > Compiler. 启用 Build project automatically
    • 点击 应用
    • Ctrl+Shift+A (Cmd+Shift+A on macOS)快捷键,然后搜索 Registry。打开之后找到 compiler.automake.allow.when.app.running,并启用它 (IntelliJ IDEA 15 and newer)。

    来源于

    Developer Tools 原理

    更多细节请查阅: Automatic Restart