本地运行HospitalRun前端项目时出现大量TypeScript错误求助

我尝试在本地运行HospitalRun前端仓库，已遵循所有操作指引，但执行npm start时出现一系列TypeScript错误，部分错误信息如下：

node_modules/@types/babel__traverse/index.d.ts:305:32 - error TS1136: Property assignment expected.

305         [K in keyof t.Aliases]?: VisitNode<S, t.Aliases[K]>;
                                   ~

node_modules/@types/babel__traverse/index.d.ts:305:48 - error TS1005: ',' expected.

305         [K in keyof t.Aliases]?: VisitNode<S, t.Aliases[K]>;
                                                   ~

node_modules/@types/babel__traverse/index.d.ts:305:60 - error TS1109: Expression expected.

305         [K in keyof t.Aliases]?: VisitNode<S, t.Aliases[K]>;
                                                               ~

node_modules/@types/babel__traverse/index.d.ts:308:21 - error TS1005: ']' expected.

308         [K in keyof VirtualTypeAliases]?: VisitNode<S, VirtualTypeAliases[K]>;
                        ~~~~~~~~~~~~~~~~~~

node_modules/@types/babel__traverse/index.d.ts:308:39 - error TS1005: ',' expected.

308         [K in keyof VirtualTypeAliases]?: VisitNode<S, VirtualTypeAliases[K]>;
                                          ~

node_modules/@types/babel__traverse/index.d.ts:308:40 - error TS1136: Property assignment expected.

308         [K in keyof VirtualTypeAliases]?: VisitNode<S, VirtualTypeAliases[K]>;
                                           ~

node_modules/@types/babel__traverse/index.d.ts:308:41 - error TS1136: Property assignment expected.

308         [K in keyof VirtualTypeAliases]?: VisitNode<S, VirtualTypeAliases[K]>;
                                            ~

node_modules/@types/babel__traverse/index.d.ts:308:74 - error TS1005: ',' expected.

308         [K in keyof VirtualTypeAliases]?: VisitNode<S, VirtualTypeAliases[K]>;
                                                                             ~

node_modules/@types/babel__traverse/index.d.ts:308:77 - error TS1005: ':' expected.

308         [K in keyof VirtualTypeAliases]?: VisitNode<S, VirtualTypeAliases[K]>;
                                                                                ~

node_modules/@types/babel__traverse/index.d.ts:308:78 - error TS1109: Expression expected.

308         [K in keyof VirtualTypeAliases]?: VisitNode<S, VirtualTypeAliases[K]>;
                                                                                 ~

node_modules/@types/babel__traverse/index.d.ts:314:11 - error TS1005: ']' expected.

314         [k: `${string}|${string}`]: VisitNode<S, Node>;
              ~

node_modules/@types/babel__traverse/index.d.ts:314:34 - error TS1005: ',' expected.

314         [k: `${string}|${string}`]: VisitNode<S, Node>;
                                     ~

node_modules/@types/babel__traverse/index.d.ts:314:35 - error TS1136: Property assignment expected.

314         [k: `${string}|${string}`]: VisitNode<S, Node>;
                                      ~

node_modules/@types/babel__traverse/index.d.ts:314:55 - error TS1005: '(' expected.

314         [k: `${string}|${string}`]: VisitNode<S, Node>;
                                                          ~

node_modules/@types/hoist-non-react-statics/node_modules/@types/react/ts5.0/index.d.ts:3340:50 - error TS1110: Type expected.

3340     type OptionalPrefixToken<T extends string> = `${T} ` | "";
                                                      ~~~

node_modules/@types/hoist-non-react-statics/node_modules/@types/react/ts5.0/index.d.ts:3341:51 - error TS1110: Type expected.

3341     type OptionalPostfixToken<T extends string> = ` ${T}` | "";

我使用Node.js 12版本，也尝试过10和14版本均未解决，怀疑是依赖版本问题但无法定位，请求协助排查。

问题原因 #

这些错误核心是本地TypeScript版本过低，无法识别类型定义文件中使用的TS新特性：

• 映射类型可选属性语法（[K in keyof ...]?）需要TS 2.9+支持
• 模板字面量类型（`${string}|${string}`）需要TS 4.1+支持
• @types/react/ts5.0中的类型定义依赖更高版本的TS环境

解决步骤 #

1. 升级项目TypeScript版本
   先检查当前项目TS版本：

   npm ls typescript
   

   若版本低于4.1，执行升级：

   npm install typescript@^4.1.0 --save-dev
   

2. 清理依赖并重新安装
   清除旧依赖缓存，避免版本冲突：

   rm -rf node_modules package-lock.json
   npm cache clean --force
   npm install
   

3. 使用项目指定的Node.js版本
   查看项目根目录的.nvmrc文件，使用对应版本的Node.js（旧版本v12/v14可能无法兼容新依赖，推荐v16或v18）。通过nvm快速切换：

   nvm use
   

4. 校验TypeScript配置
   检查tsconfig.json的compilerOptions，确保配置支持对应特性：

   {
     "compilerOptions": {
       "target": "ES2020",
       "lib": ["ES2020", "DOM"],
       "skipLibCheck": true
     }
   }
   

   开启skipLibCheck可以跳过第三方类型定义的检查，快速绕过版本兼容问题。

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