Lua Academy · 강의

package.path와 package.cpath

Lua 및 C 모듈의 검색 경로를 구성합니다.

package.path와 package.cpath은(는) CoddyKit의 무료 Lua Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Lua Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

package.path 내용

package.path는 세미콜론으로 구분된 검색 패턴 문자열입니다. 각 패턴에는 ? 자리 표시자가 있으며, 이 자리는 모듈 이름으로 대체됩니다(점은 디렉터리 구분자로 변환됩니다). Lua는 파일을 찾을 때까지 각 패턴을 순서대로 시도합니다.

print(package.path)
-- ./?.lua;./?.luac;/usr/local/share/lua/5.4/?.lua;...

-- Dots in module names become directory separators
-- require("foo.bar") -> searches for foo/bar.lua
print(("foo.bar"):gsub("%.", "/"))  -- foo/bar

검색 경로 추가

검색 디렉터리를 추가하려면 package.path 앞에 경로를 추가하십시오. 뒤에 추가하면 우선순위가 낮은 위치가 됩니다. 새 경로가 필요한 require 호출보다 먼저 이 값을 설정하십시오.

-- Add multiple directories
package.path = table.concat({
  "./?.lua",
  "./lib/?.lua",
  "./lib/?/init.lua",
  package.path,  -- keep existing paths
}, ";")

-- Now require("json") searches:
-- ./json.lua -> ./lib/json.lua -> ./lib/json/init.lua -> ...

C 확장을 위한 package.cpath

package.cpath는 C 확장 모듈의 검색 경로입니다(공유 라이브러리: Linux에서는 .so, Windows에서는 .dll, macOS에서는 .dylib). 이름 지정 규칙은 시스템 공유 라이브러리 규칙과 일치합니다.

print(package.cpath)
-- ./?.so;/usr/local/lib/lua/5.4/?.so;...

-- Add a local C library directory
package.cpath = "./clib/?.so;" .. package.cpath

-- require("myextension") will now search:
-- ./clib/myextension.so

LUA_PATH 환경 변수

LUA_PATH 환경 변수는 package.path의 초기값을 설정합니다. LUA_PATH의 ;;는 기본 경로로 대체됩니다. 스크립트를 수정하지 않고 검색 경로를 구성할 때 사용하십시오. 배포에 유용합니다.

-- Set before launching Lua:
-- export LUA_PATH="./?.lua;./lib/?.lua;;"
-- The ";;" expands to the built-in default path

-- In Lua, check what was set:
print(package.path)

-- You can also use LUA_CPATH for C paths:
-- export LUA_CPATH="./clib/?.so;;"

package.searchpath

package.searchpath(name, path)는 경로 문자열에서 이름과 일치하는 파일을 검색합니다. 처음 찾은 일치 항목을 반환하거나, 시도한 모든 위치를 나열하는 오류 메시지와 nil을 반환합니다. 실제로 파일을 로드하지 않고 파일을 찾을 때 유용합니다.

local file, err = package.searchpath("json", package.path)
if file then
  print("Found:", file)
else
  print("Not found. Tried:\n" .. err)
end

-- Useful for checking if a module exists:
local function moduleExists(name)
  return package.searchpath(name, package.path) ~= nil
end
print(moduleExists("json"))

require 검색 알고리즘

require("mod")를 호출하면 Lua는 다음 순서로 진행합니다. (1) package.loaded 확인, (2) package.preload 확인, (3) package.path에서 .lua 파일 검색, (4) package.cpath에서 C 라이브러리 검색. 가장 먼저 찾은 항목이 사용됩니다.

-- Simulate what require does:
local function myRequire(name)
  -- 1. Check cache
  if package.loaded[name] ~= nil then
    return package.loaded[name]
  end
  -- 2. Check preload
  if package.preload[name] then
    return package.preload[name]()
  end
  -- 3. Search path
  local file = package.searchpath(name, package.path)
  if file then
    return dofile(file)  -- simplified
  end
  error("module not found: " .. name)
end

로더 함수

package.searchers(이전 이름은 package.loaders)는 모듈을 찾아 로드하려고 시도하는 함수 배열입니다. 이 테이블에 사용자 지정 검색기를 추가할 수 있습니다. 각 검색기는 모듈 이름을 받아 로더 함수 또는 nil을 반환합니다.

-- Add a custom searcher that loads from a table
local builtins = {
  myconfig = function()
    return {host="localhost", port=8080}
  end
}

table.insert(package.searchers, 1, function(name)
  local loader = builtins[name]
  if loader then return loader end
end)

local cfg = require("myconfig")
print(cfg.host, cfg.port)   -- localhost  8080

모듈 이름 지정 규칙

모듈 이름은 점을 사용해 계층적으로 지정합니다: "mylib.utils". 충돌을 피하려면 일반적으로 프로젝트나 조직 이름을 최상위 네임스페이스로 사용합니다. 소문자 사용이 표준입니다. 모듈 이름에 대시는 사용하지 마십시오. Lua 문법과 충돌하므로 대신 밑줄을 사용하십시오.

-- Good: hierarchical, lowercase
-- require("myapp.db.connection")
-- require("myapp.utils.string")

-- Bad: dashes cause syntax issues in dot notation
-- local my-module = require("my-module")  -- SYNTAX ERROR
local mymodule = require("my_module")  -- ok

경로 디버깅

require가 모듈을 찾지 못하면 오류 메시지에 시도한 모든 경로가 나열됩니다. 검색 순서를 확인하려면 package.path를 출력하십시오. 대화형으로 특정 모듈 경로를 확인하려면 package.searchpath를 사용하십시오.

-- Debug require failures:
local ok, err = pcall(require, "missing_module")
if not ok then
  -- The error message shows all tried paths
  print("require failed:")
  print(err)
  print("\nCurrent package.path:")
  for path in package.path:gmatch("[^;]+") do
    print("  " .. path)
  end
end

기본 경로로 재설정

시스템 기본값이 없는 깨끗하고 최소한의 경로가 필요하다면 package.path 전체를 재설정할 수 있습니다. 파일 시스템이 제한되거나 샌드박스로 격리된 내장 Lua 환경에 유용합니다.

-- Minimal path for embedded environment
package.path  = "./?.lua;./lib/?.lua"
package.cpath = "./?.so"

-- Or get just the current directory patterns:
local function justLocal()
  return "./?.lua;./?/init.lua"
end

print("Minimal path:", justLocal())

빠른 확인

package.path 패턴의 ?는 무엇을 나타냅니까?

복습: package.path

요약:

package.path: Lua 파일 검색 패턴, ? = 모듈 이름
package.cpath: C 라이브러리 검색 패턴
우선순위가 높은 디렉터리를 추가하려면 앞에 추가합니다
LUA_PATH/LUA_CPATH 환경 변수는 초기 경로를 설정합니다
package.searchpath: 모듈을 찾을 수 있는지 확인합니다
package.searchers를 통해 사용자 지정 검색기를 추가합니다

자주 묻는 질문

“package.path와 package.cpath” 강의는 무료인가요?

네 — “package.path와 package.cpath” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Lua Academy 강의 전체를 잠금 해제할 수 있습니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“package.path와 package.cpath”에서 뭘 배우나요?

Lua 및 C 모듈의 검색 경로를 구성합니다. 브라우저에서 직접 실행하는 실습 코드로 Lua Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Lua Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Lua Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“package.path와 package.cpath” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Lua Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Lua Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Lua Academy(으)로 돌아가기