atc: 前端模板预编译器

1.2.1 verified Fri May 01 auth: no javascript deprecated

atc (Art Template Compiler) 是一款前端模板预编译工具，当前稳定版本 1.2.1，作为 artTemplate 的子项目，它将模板与目录/文件关联，支持 include 语句和文件组织。与普通模板引擎不同，atc 将模板编译为 CMD/AMD 模块，可异步加载，并依赖 SeaJS 或 RequireJS 等加载器。它包含 Windows 批处理版本和 Node.js 版本，支持路径配置和辅助方法处理。主要的前端模板优化部署工具，但项目已不再活跃更新。

Common errors

error Error: Cannot find module './lib/beautify.js' ↓

cause compiler.js 需要 beautify.js 库，但路径不对或文件缺失

fix

确保 atc 完整下载，包含 lib/beautify.js 文件

error SyntaxError: Unexpected token ILLEGAL ↓

cause 模板文件中使用了 atc 不支持的高级 JavaScript 语法或不匹配的引号/括号

fix

检查模板模板语法，确保符合 artTemplate 规范，并正确闭合标签

Warnings

deprecated 项目不再维护，可能不兼容新版本 Node.js 或加载器 ↓

fix 考虑迁移至其他模板预编译工具或使用原生 ES 模板字符串

gotcha include 语句路径不能带后缀名且不能动态拼接 ↓

fix 使用 <%include('./public/header')%> 而非 <%include('./public/header.html')%> 或 <%include('./tmpl-' + type)%>

gotcha 编译后模板依赖 SeaJS 或 RequireJS 进行异步加载，需额外引入 ↓

fix 确保页面已加载 SeaJS 或 RequireJS，并配置好 base 路径

Install

npm install template-compiler

yarn add template-compiler

pnpm add template-compiler

Imports

default
wrong
```
const compiler = require('atc/compiler.js')
```
correct
```
import 'atc/compiler.js'
```
atc 主要通过 CLI 使用，无默认导出，但 compiler.js 可被 require 执行

Quickstart

展示如何使用 atc 编译模板：Windows 双击批处理文件或 Node.js 运行 compiler.js 编译指定目录下的模板文件。

# Windows 环境：
double-click compiler.cmd

# Node.js 环境：
cd ./demo/templates/
node compiler.js