Expo项目导入外部TypeScript文件及外部共享文件夹转译配置

这个问题的核心在于Metro（Expo默认的打包工具）只会默认扫描当前项目目录内的文件，同时TypeScript也需要额外配置才能正确识别外部路径的导入。下面是一步步的实操解决方案：

1. 配置Metro打包工具（创建/修改metro.config.js） #

在你的mobile目录下新建metro.config.js文件，添加以下配置，让Metro能够监听并打包外部的shared文件夹：

const { getDefaultConfig } = require('expo/metro-config');
const path = require('path');

const config = getDefaultConfig(__dirname);

// 让Metro监听外部的shared文件夹，文件变更时能触发重新打包
config.watchFolders = [
  path.resolve(__dirname, '../shared'),
];

// 确保Metro能找到shared文件夹可能依赖的node_modules
config.resolver.nodeModulesPaths = [
  path.resolve(__dirname, 'node_modules'),
  path.resolve(__dirname, '../shared/node_modules'),
];

// 配置路径别名，把冗长的相对路径简化成友好的别名
config.resolver.alias = {
  '@shared': path.resolve(__dirname, '../shared/src'),
};

module.exports = config;

2. 配置TypeScript（修改tsconfig.json） #

在mobile/tsconfig.json里添加baseUrl和paths配置，让TypeScript编译器和你的IDE能正确识别别名路径：

{
  "extends": "expo/tsconfig.base",
  "compilerOptions": {
    "strict": true,
    "baseUrl": ".",
    "paths": {
      "@shared/*": ["../shared/src/*"]
    }
  }
}

3. 简化导入路径 #

现在你可以把原来的超长相对路径替换成别名导入：

// 替换前
import { inject } from "../../../../shared/src/core/di";

// 替换后
import { inject } from "@shared/core/di";

4. 重启Expo开发服务器 #

修改完配置后，一定要完全关闭当前的Expo服务，再重新运行npm run start，确保新配置生效。

常见排查点 #

• 如果还是报错，检查shared文件夹内的TypeScript配置（比如tsconfig.json），确保目标编译环境和Expo项目一致
• 确认shared里没有依赖移动端不支持的Node.js内置模块（比如fs、path这类仅Node端可用的模块）

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