求助：Tcl无法加载包，即使包与脚本处于同一目录

问题根源 #

Tcl不会自动扫描目录中的.tcl文件识别包声明，必须通过**包索引文件pkgIndex.tcl**来注册包，仅写package provide语句不足以让Tcl发现包。

解决方法 #

方法一：临时测试（快速验证） #

直接在调用脚本中先加载包文件，再执行package require：

source test.tcl  ;# 替换为你的包文件实际路径，比如同目录下的test.tcl
package require test 1.0

方法二：标准包管理方式（推荐） #

这是Tcl官方推荐的包部署方式，步骤如下：

1. 把你的包文件（比如test.tcl）放到单独的子目录，例如./lib/test/1.0/
2. 打开tclsh，进入上级目录（比如./lib/test/），执行索引生成命令：

pkg_mkIndex . *.tcl

执行后会在当前目录生成pkgIndex.tcl文件，Tcl会通过这个文件识别包信息。
3. 将包含pkgIndex.tcl的目录（比如./lib/test/）添加到Tcl的auto_path中：

lappend auto_path [file normalize "./lib/test/"]
package require test 1.0

或者直接把该目录放到Tcl默认的包搜索路径下（可通过puts $auto_path查看默认路径）。

注意事项 #

• MSYS2环境下请使用Unix风格路径（如/c/Users/xxx/project/lib），避免Windows反斜杠带来的路径解析问题。
• 如果包包含多个.tcl文件，执行pkg_mkIndex时指定所有相关文件即可，索引会自动处理依赖。

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