QuickJS-NG 独立可执行文件符号链接问题解析

在QuickJS-NG项目中，开发者发现了一个关于独立可执行文件符号链接的有趣问题。当用户通过PATH环境变量中的符号链接运行独立可执行文件时，程序会意外地只执行QuickJS运行时，而不是预期的打包字节码。

问题现象

开发者通过Homebrew安装了一个使用QuickJS编译的软件包envstr。当通过which命令找到的符号链接路径执行时，程序显示的是QuickJS的帮助菜单而非预期功能。然而，当使用绝对路径直接执行时，程序却能正常工作。

测试表明，这个问题在Linux和macOS系统上都会出现。当通过符号链接执行时，argv[0]只包含文件名(如"envstr")，而使用完整路径执行时则包含完整路径(如"/usr/local/bin/envstr")。

技术分析

问题的核心在于QuickJS处理独立可执行文件时对路径解析的不足。当程序通过符号链接执行时，系统传递的argv[0]参数只是简单的文件名，而QuickJS运行时未能正确处理这种情况。

在C语言层面，标准库函数realpath()在这种情况下无法工作，因为它只能解析相对于当前工作目录的路径，而无法处理PATH环境变量中的查找。类似地，在JavaScript层面也存在同样的路径解析问题。

解决方案

项目维护者提出了使用类似libuv中uv_exepath函数的解决方案。这种方法能够可靠地获取可执行文件的实际路径，无论它是通过符号链接还是直接路径执行的。

解决方案的关键点包括：

1. 在C层面(qjs.c)改进is_standalone函数，正确处理符号链接情况
2. 在JavaScript层面(standalone.js)同步改进路径解析逻辑
3. 确保跨平台兼容性，不依赖特定系统特性如Linux的/proc/self/exe

实现效果

经过修复后，无论用户是通过PATH中的符号链接还是直接路径执行独立可执行文件，QuickJS都能正确识别并执行打包的字节码。这使得通过包管理器安装的QuickJS应用程序能够像预期一样工作，大大提升了用户体验。

这个修复体现了QuickJS-NG项目对细节的关注和对跨平台兼容性的重视，确保了在各种使用场景下都能提供一致的行为。