如何自动可靠地将文件片段与上游第三方TypeScript代码同步？

针对你需要持续从非模块化TS应用中提取特定函数、并跟踪上游更新的需求，推荐以下几种实用工具和方法：

1. 基于TypeScript AST的自动提取脚本 #

用ts-morph（TypeScript AST操作库）写自定义脚本，精准定位并提取目标函数及依赖：

• 遍历上游代码的AST，匹配目标函数的名称或特征
• 自动分析该函数依赖的所有辅助函数、类型定义、变量（比如接口、类型别名、全局常量）
• 将这些内容导出到独立文件中，同时处理好模块导出逻辑（比如给提取的函数加export）
• 每次上游代码更新后，直接运行脚本就能生成最新的精简代码，完全替代手动编辑

示例脚本核心逻辑（伪代码）：

import { Project } from "ts-morph";

const project = new Project({ tsConfigFilePath: "./upstream/tsconfig.json" });
const sourceFile = project.addSourceFileAtPath("./upstream/main.ts");

// 提取目标函数
const targetFunc = sourceFile.getFunction("myTargetFunction");
// 提取依赖的类型和辅助函数
const dependencies = targetFunc.getDependencies();

// 创建新文件并写入内容
const newFile = project.createSourceFile("./dist/extracted.ts", "", { overwrite: true });
newFile.addImportDeclarations(/* 处理必要的导入 */);
newFile.addFunctions([targetFunc]);
newFile.addInterfaces(dependencies.interfaces);
newFile.saveSync();

2. 自定义代码裁剪工具 #

用babel或swc的转换插件，批量移除无关代码，只保留目标逻辑：

• 编写转换规则，标记需要保留的函数和依赖
• 对上游TS文件进行编译转换，自动删除所有未标记的代码
• 转换后的文件就是可独立运行的精简版本，上游更新后重新跑转换即可

3. 依赖追踪式提取脚本 #

借助TypeScript编译器API，深度分析目标函数的依赖链：

• 使用ts.createProgram加载上游代码，获取类型检查器
• 通过类型检查器找到目标函数的所有引用和依赖项
• 将这些依赖项与目标函数一同提取，确保独立环境中不会出现缺失依赖的问题

关键注意事项 #

• 处理全局变量：如果上游代码依赖全局变量，需在独立环境中模拟这些变量的定义
• 版本控制：把提取脚本和生成的精简代码一起纳入VCS，上游更新时优先调整脚本的匹配规则，而非手动修改精简代码
• 测试验证：每次提取后运行单元测试，确保精简代码的功能与上游一致

内容的提问来源于stack exchange，提问作者D0SBoots