TypeScript错误TS1128排查求助：预期声明或语句问题

我之前也踩过类似的TypeScript声明文件语法坑，咱们先拆解这个问题：

错误根源分析 #

TS1128错误提示「预期声明或语句」，通常是因为代码里存在语法不规范的地方——看你贴出来的index.d.ts代码，问题出在这一行：

export declare const merge: { (a: Theme, b: Theme): Theme; all: typeof mergeAll; }

这行的末尾缺少了分号，TypeScript在解析.d.ts这类严格类型文件时，对语法完整性要求很高，缺分号就会触发这个报错。

具体解决方案 #

我给你几个优先级从高到低的解决办法：

• 优先升级依赖包：这个大概率是@theme-ui/core某个版本的bug，官方应该已经修复了。直接运行命令更新到最新稳定版：

  # npm 用户
  npm update @theme-ui/core
  # yarn 用户
  yarn upgrade @theme-ui/core
  

  更新后重新编译项目，报错应该就消失了。

• 手动临时修复类型文件：如果暂时没法升级依赖，可以手动修改报错的文件：
  找到master/node_modules/@theme-ui/core/dist/index.d.ts，定位到merge声明的那一行，在末尾加上分号，修改后变成：

  export declare const merge: { (a: Theme, b: Theme): Theme; all: typeof mergeAll; };
  

  注意：这种修改会在下次npm install/yarn install时被覆盖，要是需要长期生效，可以用patch-package工具给这个包打个本地补丁。

• 检查TypeScript版本兼容性：如果你的TS版本太旧，可能对新的类型语法支持不好，导致解析报错。查看@theme-ui/core的package.json里的peerDependencies，确认你的TS版本符合要求，不符合的话升级TS：

  npm update typescript
  

额外排查小技巧 #

以后再碰到node_modules里的类型错误，先别着急自己改代码，优先查包的版本是否有更新——这类语法问题几乎都是包的bug，官方修复速度通常很快，升级是最省心的解决方式。

内容的提问来源于stack exchange，提问作者Nicole Höfler