Forge CLI报错‘document must have at least 1 module’含义及解决方法

这个错误的原因很直接：空白模板生成的manifest.yml没有定义任何Forge功能模块，而Forge要求每个应用必须至少包含一个模块（比如UI宏、后台函数、触发器等）才能通过校验和部署。

解决步骤： #

1. 修改manifest.yml，添加至少一个模块
   打开自动生成的manifest.yml，补充modules字段。以下是最基础的Confluence页面宏示例（你可以根据目标产品选择对应的模块类型，比如Jira的issuePanel等）：

   app:
     id: "ari:cloud:ecosystem::app/你的应用ID" # 保留生成的ID即可
     name: Hello World
   modules:
     confluence:pageMacro:
       - key: hello-world-macro
         name: Hello World Macro
         description: 简单的Hello World宏
         url: src/index.js
         icon: https://developer.atlassian.com/platform/forge/images/forge-logo.svg
   permissions:
     scopes:
       - read:confluence-content.summary
   

2. 补充src/index.js的对应模块代码
   确保你的入口文件包含模块的实现逻辑，比如对应上面的页面宏：

   import ForgeUI, { render, Macro } from "@forge/ui";
   
   const App = () => {
     return <Macro>Hello World!</Macro>;
   };
   
   export const run = render(<App />);
   

完成以上修改后，重新执行forge lint或forge deploy，这个错误就会消失。

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