第8章 - 最佳实践与常见坑

-- ❌ Java 思维
local arr = {"a", "b", "c"}
print(arr[0])    -- nil！不是 "a"！

-- ✅ Lua 正确写法
print(arr[1])    -- a

-- ❌ Java 思维
if a != b then    -- 语法错误！

-- ✅ Lua 正确写法
if a ~= b then

-- ❌ Java/C 思维
local count = 0
if count then
    print("这会执行！")    -- 会执行！0 是真值！
end

-- ✅ 正确的判断方式
if count ~= 0 then
    print("count 不为零")
end

-- 同样，空字符串也是真值
local s = ""
if s then
    print("空字符串也是真的！")    -- 会执行！
end
if #s > 0 then
    print("字符串不为空")          -- 正确判断方式
end

-- ❌ 忘记 local，变成全局变量
function process()
    result = "hello"    -- 这是全局变量！会污染全局环境
end

-- ✅ 始终使用 local
function process()
    local result = "hello"    -- 局部变量，安全
end

-- ❌ Java 思维
for i = 1, 10 do
    if i % 2 == 0 then
        continue    -- 语法错误！Lua 没有 continue
    end
    print(i)
end

-- ✅ 方案一：goto（推荐）
for i = 1, 10 do
    if i % 2 == 0 then goto continue end
    print(i)
    ::continue::
end

-- ✅ 方案二：if 包裹
for i = 1, 10 do
    if i % 2 ~= 0 then
        print(i)
    end
end

-- ❌ Java 思维
count++        -- 错误！
count += 1     -- 错误！

-- ✅ Lua 写法
count = count + 1

-- ❌ Java 思维
local s = "Hello" + " World"    -- 错误！+ 是算术运算

-- ✅ Lua 写法
local s = "Hello" .. " World"

-- 更要小心的是：
print("count: " + 5)    -- 报错！"count: " 不能转成数字
print("count: " .. 5)   -- 正确：count: 5
print("10" + 5)          -- 15（字符串自动转数字做运算）

-- ❌ Java 思维（以为是整数除法）
print(10 / 3)     -- 3.3333...（不是 3！）

-- ✅ 整数除法用 //
print(10 // 3)    -- 3

-- ❌ Java 思维
if a && b then       -- 错误！
if a || b then       -- 错误！
if !a then           -- 错误！

-- ✅ Lua 写法
if a and b then
if a or b then
if not a then

-- ❌ 以为是值复制
local a = {1, 2, 3}
local b = a         -- b 和 a 指向同一个 table！
b[1] = 100
print(a[1])         -- 100（a 也被改了！）

-- ✅ 手动复制
local function copyTable(t)
    local copy = {}
    for k, v in pairs(t) do
        copy[k] = v
    end
    return copy
end
local c = copyTable(a)

-- 局部变量和函数：小驼峰（camelCase）
local userName = "长安"
local function getUserInfo() end

-- 常量：全大写 + 下划线
local MAX_RETRY = 3
local DEFAULT_TIMEOUT = 5000

-- 模块名：小写
local mymodule = require("mymodule")

-- "类"名：大驼峰（PascalCase）
local Animal = {}
local HttpClient = {}

-- 私有变量/函数：下划线前缀
local _privateVar = "secret"
local function _internalProcess() end

-- 1. 始终使用 local
local x = 10

-- 2. 函数定义用 local function
local function foo()
end

-- 3. 字符串优先用双引号
local name = "长安"

-- 4. 表的最后一个元素也加逗号（方便增删）
local config = {
    host = "localhost",
    port = 8080,
    debug = true,     -- 最后也加逗号
}

-- 5. 善用提前返回，减少嵌套
local function validate(data)
    if not data then return false, "data is nil" end
    if not data.name then return false, "name is required" end
    if #data.name < 3 then return false, "name too short" end
    return true
end

-- ❌ 每次调用都要查全局表
for i = 1, 1000000 do
    math.sin(i)           -- 每次查找 math 表 → sin 函数
end

-- ✅ 缓存到局部变量（性能提升 30%+）
local sin = math.sin
for i = 1, 1000000 do
    sin(i)                -- 直接调用局部变量
end

-- ❌ 循环中创建大量临时 table
for i = 1, 100000 do
    local point = {x = i, y = i * 2}    -- 每次都创建新 table
    process(point)
end

-- ✅ 复用 table
local point = {}
for i = 1, 100000 do
    point.x = i
    point.y = i * 2
    process(point)
end

-- ❌ 大量字符串拼接（每次创建新字符串，类似 Java 的 String +）
local result = ""
for i = 1, 10000 do
    result = result .. "line " .. i .. "\n"
end

-- ✅ 用 table.concat（类似 Java 的 StringBuilder）
local parts = {}
for i = 1, 10000 do
    parts[#parts + 1] = "line " .. i
end
local result = table.concat(parts, "\n")

-- 如果你知道 table 的大致大小，可以预先创建
-- LuaJIT 的 table.new 可以指定数组和哈希部分的大小
local ffi = require("ffi")
local tab_new = require("table.new")

local t = tab_new(1000, 0)    -- 预分配 1000 个数组位置
for i = 1, 1000 do
    t[i] = i
end