IntelliJ Ultimate Velocity编辑器无法解析PACKAGE_NAME变量

问题还原 #

我在IntelliJ Ultimate中使用内置的Velocity插件编写文件模板，代码示例如下：

package ${PACKAGE_NAME}

但出现报错（截图如下），最终目标是编写可复制到Android Studio使用的文件模板。

排查与解决步骤 #

• 手动指定文件数据语言
  右键当前模板文件，选择「File Data Languages」，将该文件关联为Velocity语言。IntelliJ不会自动识别普通文本文件为Velocity模板，手动关联后语法校验会正常工作。
• 确保在IDE的模板面板中创建文件
  不要在普通项目目录里新建文本文件写模板，而是通过「Settings → Editor → File and Code Templates」面板创建模板。只有在这个面板里，IDE才会识别${PACKAGE_NAME}这类内置模板变量，不会报错。
• 确认Velocity插件启用
  进入「Settings → Plugins」，搜索Velocity插件，确保它处于启用状态（IntelliJ默认内置启用，但偶尔可能被误关）。
• 复制到Android Studio的注意事项
  Android Studio的文件模板规则和IntelliJ完全兼容，直接把调试好的模板内容复制到Android Studio的「File and Code Templates」对应位置即可，${PACKAGE_NAME}这类变量通用无需修改。

内容的提问来源于stack exchange，提问作者me.at.coding