Oracle中可重用PACKAGE的关键在于接口与实现分离、会话级状态管理及调用边界控制：包头是契约，只声明不写逻辑；包体是运行时容器，须严格对应且含初始化段；包级变量会话持久，需防误用残留。
直接说结论：oracle里写可重用的package，关键不在“怎么写语法”，而在于“怎么拆接口和实现”“怎么管状态”“怎么防误调用”。包头不是草稿纸，是契约；包体不是堆代码的地方，是运行时容器。
包头（PACKAGE）只声明，不写逻辑
包头是外部唯一能看见的部分，它定义了别人怎么用你。任何执行语句、赋值、SELECT、UPDATE都禁止出现在包头里。
- 只能放：
PROCEDURE和FUNCTION签名（含参数名、类型、IN/OUT）、TYPE定义（如RECORD或REF CURSOR）、公共常量（c_max_retry CONSTANT NUMBER := 3）、包级变量（如v_last_run DATE） - 常见错误：在包头里写
SELECT ... INTO ...，或给变量赋初值时用了函数调用（如v_now DATE := SYSDATE）——这会导致编译失败，因为包头不允许执行上下文 - 命名建议：包名带业务前缀（如
pkg_order），函数/过程名动词开头（validate_payment），避免缩写歧义
包体（PACKAGE BODY）必须严格对应包头
包体里每个子程序的名字、参数个数、参数顺序、参数模式（IN/OUT/IN OUT）、返回类型，必须和包头一模一样，否则调用时会报PLS-00306: wrong number or types of arguments。
- 私有逻辑写在这里：比如校验规则、临时表操作、内部游标循环，这些不用暴露给外部
- 初始化段（BEGIN...END; 在所有子程序定义之后）会被执行一次——可用于设置默认值，例如
g_batch_id := 0; - 注意异常处理粒度：不要在包体顶层
EXCEPTION里捕获所有WHEN OTHERS并NULL掉，这会让调用方收不到错误；应让具体过程自己处理可恢复错误，把不可恢复的抛出去
包级变量是会话级状态，不是全局变量
PACKAGE里的变量（如v_counter NUMBER := 0）在同一个数据库会话中跨多次调用保持值，但不同会话之间完全隔离。这点和独立存储过程完全不同，也是最容易被忽略的“坑”。
- 适用场景：缓存查询结果（如
g_dept_cache SYS_REFCURSOR）、统计调用次数、维护事务上下文标识 - 风险点：如果某个过程修改了
v_status，后续同一会话中其他过程可能读到脏值；尤其在Web应用中，连接池复用会话，变量残留可能引发逻辑错乱 - 规避方式：显式重置（如入口过程开头加
v_status := NULL;），或改用参数传递代替隐式状态依赖
调用时必须带包名前缀，且权限需授给整个包
不能像调用独立过程那样省略包名，raise_salary(101, 5)会报PLS-00201: identifier 'RAISE_SALARY' must be declared；必须写成emp_pkg.raise_salary(101, 5)。
- 权限管理更简单：只需
GRANT EXECUTE ON emp_pkg TO app_user;，无需逐个授权每个过程 - 但如果包里用了动态SQL（
EXECUTE IMMEDIATE）或访问了其他用户对象，调用者还需额外有对应表的SELECT等权限——包本身不自动继承定义者权限 - 调试时别只查
user_source看包头，要一起查user_errors确认包体是否编译成功；SHOW ERRORS PACKAGE BODY emp_pkg比反复点PL/SQL Developer的“编译”按钮更可靠
真正难的不是写出语法正确的PACKAGE，而是判断哪些该放进包级变量、哪些该作为参数传入、哪些错误该吞掉、哪些该冒泡——这些决定直接影响下游系统能否安全复用。状态、边界、契约，三者缺一不可。
