MacOS Sonoma 14.2.1下Lua require找不到socket模块，如何解决？

问题背景 #

环境：MacOS Sonoma 14.2.1，Lua版本5.4.7

在luaclient.lua脚本第2行编写代码：

local socket = require('socket')

运行脚本时出现错误：

lua: luaclient.lua:2: module 'socket' not found:
    no field package.preload['socket']
    no file '/usr/local/share/lua/5.4/socket.lua'
    no file '/usr/local/share/lua/5.4/socket/init.lua'
    no file '/usr/local/lib/lua/5.4/socket.lua'
    no file '/usr/local/lib/lua/5.4/socket/init.lua'
    no file './socket.lua'
    no file './socket/init.lua'
    no file '/usr/local/lib/lua/5.4/socket.so'
    no file '/usr/local/lib/lua/5.4/loadall.so'
    no file './socket.so'
stack traceback:
    [C]: in function 'require'
    luaclient.lua:2: in main chunk
    [C]: in ?

socket模块实际安装路径：/Users/user_name/.luarocks/share/lua/5.4

查看Lua的package.path输出：

/usr/local/share/lua/5.4/?.lua;/usr/local/share/lua/5.4/?/init.lua;/usr/local/lib/lua/5.4/?.lua;/usr/local/lib/lua/5.4/?/init.lua;./?.lua;./?/init.lua

尝试在shell中执行命令：

set LUA_PATH '/Users/perryhorwich/.luarocks/share/lua/5.4/?.lua'

但执行脚本后仍报错，LUA_PATH未生效。

问题原因及解决方法 #

• 环境变量设置命令错误：在bash/zsh这类shell里，set不能用来设置环境变量，正确的方式是用export。而且直接覆盖LUA_PATH会丢失默认的搜索路径，应该把luarocks的路径追加进去，命令如下：

  export LUA_PATH="/Users/perryhorwich/.luarocks/share/lua/5.4/?.lua;/Users/perryhorwich/.luarocks/share/lua/5.4/?/init.lua;$LUA_PATH"
  

  注意把路径里的perryhorwich替换成你实际的用户名，和模块安装路径一致。

• 临时生效限制：上面的export命令只在当前shell会话有效，如果要每次打开shell都生效，需要把这条命令添加到你的shell配置文件中，比如~/.zshrc（zsh用户）或~/.bashrc（bash用户），添加后执行source ~/.zshrc（对应你的配置文件）让修改立即生效。

• 利用luarocks自动生成路径：luarocks自带命令可以输出正确的路径配置，执行luarocks path，会得到现成的LUA_PATH和LUA_CPATH设置命令，直接复制执行或者加到配置文件里，比手动输入更准确。

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