Git仓库作为包使用时的符号链接路径异常问题

问题描述 #

我在一个翻译项目里，需要用controls.json作为配置控制文件，为了符合项目目录结构，得在en、pt、es每个语言目录下都放这个文件。我尝试用符号链接解决，执行命令：

ln -rs src/controls.json src/locales/*/

本地用symlinks工具查看时，链接路径是正确的相对路径：

symlinks -rv . | grep controls

relative: $HOME/resources/src/locales/es/controls.json -> ../../controls.json
relative: $HOME/resources/src/locales/en/controls.json -> ../../controls.json
relative: $HOME/resources/src/locales/pt/controls.json -> ../../controls.json

但把仓库推送到远端后，在主项目里通过package.json作为依赖包引入，所有符号链接都变成了悬空状态，链接路径变成了指向src/controls.json的绝对路径：

symlinks -rv node_modules/resources | grep controls 

dangling: $HOME/project/node_modules/resources/src/locales/es/controls.json -> src/controls.json
dangling: $HOME/project/node_modules/resources/src/locales/en/controls.json -> src/controls.json
dangling: $HOME/project/node_modules/resources/src/locales/pt/controls.json -> src/controls.json

项目使用i18n后端插件，必须遵循这个目录结构，请问怎么保持符号链接的相对路径，或者有没有更优的解决方案？

解决方案 #

1. 调整符号链接创建方式 #

问题出在npm安装依赖时对ln -rs生成的递归相对路径解析有差异。可以换为进入目标目录后创建链接，确保路径基于目标目录的相对定位：

cd src/locales/en && ln -s ../../controls.json . && cd -
cd src/locales/pt && ln -s ../../controls.json . && cd -
cd src/locales/es && ln -s ../../controls.json . && cd -

这种方式生成的链接路径更稳定，npm安装后不会被篡改。

2. 用npm脚本自动复制文件（替代符号链接） #

如果符号链接的兼容性问题无法解决，可在依赖包的package.json中添加prepare脚本，在依赖安装时自动复制配置文件到各语言目录：

{
  "scripts": {
    "prepare": "cp src/controls.json src/locales/en/ && cp src/controls.json src/locales/pt/ && cp src/controls.json src/locales/es/"
  }
}

每次依赖被安装时，都会自动同步源文件到指定目录，彻底避开符号链接问题。

3. 修改i18n插件配置实现共享 #

如果i18n插件支持自定义配置读取逻辑，可以直接配置它读取根目录的controls.json，无需在每个语言目录下存放副本。比如检查插件是否有sharedConfig类配置项，或通过自定义加载函数让所有语言目录共享同一配置文件。

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