MacOS下在Visual Studio Code中运行Grails/GSP项目并预览本地修改

1. 安装核心依赖 #

Grails基于Java运行，先确认项目对应的Java版本（查看项目根目录的gradle.properties或grails-app/conf/application.groovy：Grails 4对应Java 8/11，Grails 5对应Java 11/17，Grails 6对应Java 17+）

• 用Homebrew安装对应版本的OpenJDK，比如安装Java 11：

  brew install openjdk@11
  

• 验证安装：

  java -version
  

2. VS Code配置插件 #

打开VS Code，安装以下插件提升开发体验：

• Extension Pack for Java：提供Java语言基础支持
• Groovy Lint：实现GSP/Groovy代码的语法检查与高亮
• Grails Support：提供Grails项目的快捷操作与代码提示

3. 本地启动项目 #

1. 在VS Code中打开克隆后的项目根目录
2. 打开内置终端（快捷键Ctrl+），执行对应启动命令：
   • 大多数Grails 3+项目基于Gradle构建，直接运行：

     ./gradlew bootRun
     

   • 若为Grails 2及以下的老版本项目，需先安装Grails CLI：

     brew install grails
     

     再启动项目：

     grails run-app
     

3. 等待控制台输出启动成功信息，默认访问地址为http://localhost:8080（若端口被占用，控制台会显示新的端口号）

4. 预览修改效果 #

修改GSP、CSS文件后，Grails默认开启热重载，无需重启项目，直接刷新浏览器即可看到修改效果。如果热重载未生效，可尝试重启项目或检查项目配置文件中的热重载开关。

内容的提问来源于stack exchange，提问作者Juani Vitale