TypeScript 2026 npm 库脚手架

基于 Node 24 原生 ESM，利用"源码直连"实现免 build 实时调试；通过 esbuild 抹除后缀并配合 publishConfig，兼顾开发爽感与发布标准。

📦 创建新库

PowerShell (Windows)

$lib = "xstart"
git clone -b xstart [email protected]:xghini/mynpm.git $lib && cd $lib
(Get-Content package.json) -replace 'xstart', $lib | Set-Content package.json
(Get-Content app/0.ts) -replace 'xstart', $lib | Set-Content app/0.ts
Remove-Item -Recurse -Force .git
git init && git add . && git commit -m "init $lib"
git branch -M $lib && git remote add origin [email protected]:xghini/mynpm.git
git push -u origin $lib -f && pnpm i && pnpm pub

Bash (Linux/macOS)

lib="xstart"
git clone -b xstart [email protected]:xghini/mynpm.git $lib && cd $lib
perl -i -pe "s/xstart/$lib/g" package.json app/0.ts
rm -rf .git
git init && git add . && git commit -m "init $lib"
git branch -M $lib && git remote add origin [email protected]:xghini/mynpm.git
git push -u origin $lib -f && pnpm i && pnpm pub

🚀 开发命令

pnpm test          # 运行测试
pnpm test:watch    # 监听模式
pnpm test:coverage # 覆盖率报告
pnpm typecheck     # 类型检查
pnpm build         # 编译 + 打包 + 更新版本号
pnpm pub           # 构建 + 发布 + 提交

💡 核心设计

• 源码直连：开发态 exports 指向 src/*.ts，Node 24 原生支持直接运行 TypeScript
• 双模切换：publishConfig 发布时自动切回 dist/*.js，确保兼容性
• 自动版本：build.js 内置日期版本算法（如 26.1.5161805）
• 路径处理：xpath 默认相对于入口脚本目录，支持 pm2 等场景通过 KIT_EXEPATH 环境变量覆盖

🔧 pnpm 迁移

pnpm import
Remove-Item -Recurse -Force node_modules
Remove-Item package-lock.json
pnpm i