Skip to content

包导入

这页解释 Targo 项目如何消费 Go 包,以及什么时候需要刷新声明。

核心规则

当导入、依赖或绑定相关配置发生变化时,先刷新声明再信任类型信息。

通常意味着:

bash
targo init

导入模型

  • 从 Targo 源码直接导入 Go 包
  • 把它们当作 Go 包,而不是 JavaScript 模块
  • 如果类型信息异常,优先重新生成而不是手改声明

声明与刷新

  • tsconfig.targo.json 是把当前声明状态接入 TS 工程的生成文件
  • types/** 用于本地 Go 目录绑定
  • project-local .targo/ 只应出现在 vendored 或兼容路径中

什么时候刷新

下面这些变化通常都应触发刷新:

  • go.mod
  • 新增或变更 Go 包导入
  • binder 相关配置
  • targo.json

实践规则

  • 不手改生成声明
  • 不把 tsconfig.targo.jsontypes/ 或 vendored .targo/ 当作手写源码
  • 类型缺失时先确认导入路径和声明刷新流程,而不是直接 patch 生成文件