安装指南

完成安装与环境准备,快速开始模板开发

1

下载与安装

选择适合你系统的安装包

请根据操作系统下载对应安装包并完成安装,详细链接见 INSTALL.md 或官网安装页。

# 安装完成后验证
tmaker --version
# 或使用简写
mk --version

💡 小贴士

  • • 安装后建议重启终端
  • • macOS/Linux 可使用 PKG/DEB 安装包
2

环境准备

准备构建依赖

建议准备 .NET 10 Runtime 与 Node.js 24+,以保证模板构建流程顺利。

💡 小贴士

  • • Node.js 用于 Tailwind CSS 构建
  • • 运行目录需包含 templates/ 与 config.json
3

创建模板

初始化模板目录结构

cd TMaker

# 创建简化模板
tmaker create mysite

💡 小贴士

  • • 完整模板可使用 tmaker template create
  • • 推荐在 VS Code 中统一管理工程
4

渲染预览

生成输出并预览

tmaker render mysite
tmaker preview mysite

浏览器访问 http://localhost:1688 查看效果。

💡 小贴士

  • • 修改内容后需要重新 render
  • • 预览端口可使用 -p 指定

常见问题

❓ 命令未找到:tmaker

请确认已安装并重启终端。

❓ 渲染失败:找不到模板文件

确保在 TMaker 目录下运行命令(不是 templates/mysite)。

遇到其他问题?