TYPO3扩展开发：JavaScript模块最优存放及源码压缩管理问题

核心思路 #

将带调试信息的源码存放在Git仓库专属的开发目录，通过构建脚本自动生成压缩版到TYPO3要求的模块路径，同时通过Git配置控制文件的仓库存储与分发范围。

具体实现步骤 #

1. 调整目录结构 #

• 在扩展根目录新建Resources/Private/JavaScript/Backend/目录，存放带console.log()的源码文件，命名为Iconpack.src.js
• 保留Resources/Public/JavaScript/Backend/Iconpack.js作为最终加载的压缩版（由构建脚本自动生成）

2. 配置构建脚本（以npm为例） #

在扩展根目录创建package.json，引入压缩工具（如terser）并添加构建命令：

{
  "scripts": {
    "build:js": "terser Resources/Private/JavaScript/Backend/Iconpack.src.js --compress --mangle --output Resources/Public/JavaScript/Backend/Iconpack.js"
  },
  "devDependencies": {
    "terser": "^5.19.2"
  }
}

开发时执行npm run build:js，即可自动生成符合命名空间要求的压缩版文件，保证TYPO3/CMS/Iconpack/Backend/Iconpack的路径有效性。

3. 配置Git与分发规则 #

• .gitignore：添加规则忽略自动生成的压缩版，确保Git仓库仅存储源码：

  Resources/Public/JavaScript/Backend/Iconpack.js
  

• .gitattributes：控制Composer和TER分发时的文件范围：

  # 排除源码目录，不进入TER或Composer分发包
  Resources/Private/JavaScript/Backend/ export-ignore
  # 强制包含压缩版文件
  Resources/Public/JavaScript/Backend/Iconpack.js export-include
  

4. 协作与开发规范 #

• 开发人员克隆仓库后，先执行npm install安装依赖，再运行npm run build:js生成压缩版用于本地调试
• 提交代码仅提交源码、构建配置文件，压缩版可通过CI/CD自动生成（可选），或在发布扩展前手动构建后再打包分发

替代方案（无npm工具时） #

若不想使用Node.js工具，也可使用TYPO3官方支持的grunt或gulp构建流程，核心逻辑保持一致：源码存私有目录，构建输出到公共模块路径，确保命名空间符合要求。

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