如何用Jac写第一个程序:Python开发者必会的8个核心语法(含代码示例)
如何用Jac写第一个程序:Python开发者必会的8个核心语法(含代码示例)
Jac 是一门语法接近 Python 的新型编程语言,支持把同一份代码编译到 CLI、Web、桌面端与 AI 场景("一种语言,覆盖所有技术栈")。如果你是 Python 开发者,本文带你用最短路径写出第一个 Jac 程序,并系统掌握 8 个核心语法:with entry、大括号与分号、类型注解、def 函数、控制流、obj 类、enum 枚举,以及 Jac 独有的 AI 函数 by llm()。
🚀 为什么 Python 开发者值得花 10 分钟了解 Jac?
- 语法像 Python,目标不止 Python:Jac 可编译为 Python 字节码、JavaScript 和原生机器码,PyPI 与 npm 的库可以直接导入,无需 FFI 胶水层(见 jac/README.md)。
- AI 是一等语言结构:一个函数体可以整体替换成 LLM 模型,
by llm()就能声明"这个函数由 AI 实现"。 - 一份代码,多种形态:同一个文件既能当后端接口(
def:pub),又能写 JSX 组件渲染成 Web 页面。
一键安装:Jac 环境准备
Jac 官方以单个自包含原生二进制分发,不需要系统 Python、pip 或 uv。从源码构建只需 clone 后运行引导脚本(详见 scripts/fresh_env.sh 与 jac/README.md):
git clone https://gitcode.com/gh_mirrors/ja/jac
cd jac
./scripts/fresh_env.sh # 构建 jac 二进制并加入 PATH
jac --version # 验证安装
你的第一个 Jac 程序:Hello World
新建 hello.jac,内容如下(注意:没有 if __name__ == "__main__",Jac 用 with entry 块标记程序入口):
with entry {
print("Hello from Jac!");
}
运行它:
jac run hello.jac
输出 Hello from Jac!,你的第一个 Jac 程序就跑起来了(jac 是 jac run 的简写)。
8 个核心语法逐个拆解
1️⃣ 程序入口:with entry
对应 Python 的 if __name__ == "__main__":。Jac 约定把顶层入口逻辑写在 with entry { ... } 块中,这是每个脚本的起点。
2️⃣ 大括号 + 分号:告别纯缩进
Jac 保留了 Python 风格的表达式,但用花括号界定代码块、分号结束语句,嵌套深时更不容易出缩进错乱:
| 场景 | Python | Jac |
|---|---|---|
| 入口 | if __name__ == "__main__": |
with entry { ... } |
| 代码块 | 缩进 | { ... } |
| 语句结束 | 换行 | ; |
| 类 | class Todo: |
obj Todo { ... } |
3️⃣ 变量声明与类型注解
变量可以像 Python 一样直接赋值,也可以加上类型注解(推荐,编译器能帮你查错):
with entry {
name: str = "Jac";
year: int = 2025;
print(f"Hello, {name}! Born in {year}.");
}
f-string 写法与 Python 完全一致。完整示例可参考 jac/examples/mini_todo/test_local.jac。
4️⃣ 函数:def + 返回类型
参数和返回值都建议标注类型,块体用花括号:
def greet(name: str) -> str {
return f"Hello, {name}!";
}
with entry {
print(greet("developer"));
}
Jac 还支持声明与实现分离:先写 def greet(name: str) -> str;(只有签名),实现放在同名 .impl.jac 文件里用 impl 关键字——这个模式在官方国际象棋示例中被完整使用:jac/examples/chess/chess.jac 与 jac/examples/chess/chess.impl.jac。
5️⃣ 控制流与循环:if / elif / else 和 for
with entry {
scores = [85, 92, 60];
for s in scores {
if s >= 90 {
print(f"{s} 优秀");
} elif s >= 60 {
print(f"{s} 及格");
} else {
print(f"{s} 再练练");
}
}
}
列表推导式同样支持:[s for s in scores if s >= 60]。
6️⃣ 类:obj 与 has 字段
Jac 用 obj 代替 class,字段统一写在 has 子句中,方法内部通过 self 引用实例:
obj Todo {
has title: str,
done: bool = False;
def mark_done {
self.done = True;
}
def summary -> str {
return f"[{'x' if self.done else ' '}] {self.title}";
}
}
with entry {
todo = Todo(title="学完 Jac 8 个核心语法");
print(todo.summary());
todo.mark_done();
print(todo.summary());
}
真实项目中的 obj 用法(含字段默认值、方法)可看 jac/examples/mini_todo/main.jac。
7️⃣ 枚举:enum
一行定义,比 Python 的 Enum 简洁得多:
enum Priority: int { LOW, NORMAL, HIGH }
with entry {
print(Priority.HIGH);
}
8️⃣ AI 函数:by llm()(Jac 的灵魂特性)
声明一个函数,把函数体交给大模型:只需写清参数、返回类型和提示词,运行时由 LLM 完成实现:
enum Category { WORK, PERSONAL, OTHER }
def categorize(title: str) -> Category by llm();
sem categorize = "根据任务标题判断它属于哪个类别";
with entry {
print(categorize("给老板交季度报表")); # -> Category.WORK
}
这一招在 jac/examples/mini_todo/main.jac 和 jac/examples/day_planner/basic/main.jac 中都有实战。
组合技:10 行代码写个小工具
把上面的语法串起来——枚举定类别、obj 建模型、for 做统计:
enum Status { TODO, DONE }
obj Task {
has title: str,
status: Status = Status.TODO;
}
with entry {
tasks = [Task(title="安装 Jac"), Task(title="写第一个程序")];
tasks[0].status = Status.DONE;
for t in tasks {
print(f"{t.status}: {t.title}");
}
}
jac run 它,你会看到 DONE: 安装 Jac 和 TODO: 写第一个程序。
一份代码,跑在多种平台上
Jac 的野心不止命令行:给函数加上 def:pub 前缀它就自动变成后端接口,用 JSX 写 def:pub app -> JsxElement 就自动渲染成前端页面,同一份代码还能出 Web、桌面、移动端多端形态。下例的 Web 界面就是纯 Jac 代码跑出来的社区应用:
想照抄一个能直接跑的样板,建议从这两个小项目开始:
- jac/examples/mini_todo/:最小的 AI 待办应用,
node/obj、enum、by llm()一次看全; - jac/examples/day_planner/basic/:单文件全栈应用,
def:pub后端 + JSX 前端。
下一步:继续深入 Jac
| 想做什么 | 去哪里看 |
|---|---|
| 官方快速上手与命令说明 | jac/jaclang/cli/docs/quick-guide/index.md |
| 从零构建第一个全栈应用教程 | jac/jaclang/cli/docs/tutorials/first-app/build-ai-day-planner.md |
更完整的 obj/enum/声明实现分离范例 |
jac/examples/chess/ |
| 更多可运行示例(Todo、日程、国际象棋、游戏) | jac/examples/ |
| 项目总览:Jac 能做什么、如何安装 | jac/README.md |
小结:Jac 对 Python 开发者的学习成本极低——把缩进换成大括号、class 换成 obj、入口换成 with entry,再尝一口 by llm() 这个"函数体即模型"的甜头,你就已经站在了一门"人写、AI 也写、多端都能跑"的语言入口上。


