安装与配置

这页讲的是如何把开发环境准备好，以及第一次搭起项目时应该关注什么。

环境要求

• Node.js 18+
• Go 1.22+
• npm、pnpm 或 yarn 任一包管理器

推荐安装方式

方式一：直接创建新项目

这是最推荐的路径：

npx @targo/create-targo my-app
cd my-app

适合：

• 第一次接触 Targo
• 想快速拿到一个可运行项目
• 希望默认带上 agent docs 和基础配置

方式二：在现有项目中使用 CLI

npm install -D @targo/cli

然后运行：

targo init

适合：

• 你已经有现成仓库
• 你希望逐步接入 Targo

第一次初始化后会看到什么

你最需要理解的是这些文件：

• src/：源码
• targo.json：Targo 相关配置
• tsconfig.json：TypeScript 工程配置
• tsconfig.targo.json：生成的声明 include 配置
• go.mod：Go module 配置
• types/：本地 Go 目录绑定时的可选声明输出

如果是新脚手架项目，还会看到：

• AGENTS.md
• .targo-docs/

推荐的第一次检查

targo init
targo check
targo build

这三步分别回答：

• 声明和项目状态是否已刷新
• 类型和配置是否有效
• 是否能成功编译到 Go

配置上要先知道什么

第一次不需要把所有配置吃透。
先记住：

• targo.json 决定 Targo 行为
• tsconfig.json 主要影响 TS/editor 体验
• tsconfig.targo.json、types/ 和 vendored .targo/ 不手改

更精确的命令和配置参考

如果你需要的是精确边界，而不是安装引导，请看：

• CLI Commands
• Configuration
• Package Imports