Sublime Text默认不识别.tcl文件为Tcl语言，因语法绑定、作用域解析和构建路径三者未对齐：需手动绑定语法、新建增强语法包区分变量作用域、配置tclsh绝对路径。
Sublime Text 默认不识别 .tcl 文件为 Tcl 语言，也不高亮变量名、过程参数或 global 引用——这不是插件没装好，而是语法绑定、作用域解析和构建路径三者都没对齐。
为什么 .tcl 文件打开还是 Plain Text？
Sublime Text 不靠后缀自动判定语言，也不读 #!/usr/bin/env tclsh 这类 shebang。右下角显示 Plain Text，说明当前 view 没加载任何 Tcl 语法定义。
- 临时解决：点击右下角语言名 → 选
Tcl（注意不是Tcl (Legacy)或ShellScript） - 永久绑定：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Preferences: Settings – Syntax Specific，添加：{"extensions": ["tcl", "tm", "itcl"]} - 慎用硬配：如果文件是
.test或.cmd，别直接往extensions里加——这些后缀常混用多种语言；更稳妥的是在文件头加# -- tcl --，Tcl 语法包会识别并自动切换
为什么 set 后的变量名不着色？
内置 Packages/Tcl/Tcl.sublime-syntax 只做词法切分，不推导语义上下文。它把 set foo 123 中的 foo 和 string trim 中的 trim 当作同一类标识符，全标成 variable.other.tcl 或干脆不标。
- 不要改系统自带语法文件——下次升级会被覆盖
- 新建用户语法包，例如
Packages/User/TclEnhanced.sublime-syntax - 重点捕获
set、proc、global、upvar、variable这几条语句，在其后匹配变量名时加\b词边界和前后断言，避免误标string trim - 给不同上下文的变量赋予不同 scope：
variable.parameter.tcl（过程参数）、variable.other.tcl（局部变量）、variable.global.tcl（全局引用）
tclsh: command not found 怎么办？
这不是脚本错了，是 Sublime 的构建系统找不到 tclsh 可执行路径。它不读 shell 的 $PATH，只认绝对路径或显式 path 字段。
- 先确认位置：终端运行
which tclsh（macOS/Linux）或where tclsh（Windows），例如/opt/homebrew/bin/tclsh或C:\Tcl\bin\tclsh86.exe - 在
Packages/User/Tcl.sublime-build中写死路径：{"cmd": ["/opt/homebrew/bin/tclsh", "$file"]} - 或者用
path字段补全：{"path": "/opt/homebrew/bin:/usr/local/bin"}（Windows 用;分隔，但 Sublime 内部统一支持/） - 别用
"cmd": ["tclsh", "$file"]—— 在 Sublime 里一定失败
怎么让自定义语法包生效？
光放对位置不够，还得让 Sublime 明确“这是 Tcl，且优先于系统内置的”。常见现象是右下角仍显示 Tcl 而非你起的 Tcl (Enhanced)，说明绑定失败。
- 确保自定义语法文件（如
TclEnhanced.sublime-syntax）放在Packages/User/目录下 - 文件中必须包含明确的
file_extensions字段：file_extensions: ["tcl", "tm"]
-
name字段不能与系统 Tcl 冲突，建议用Tcl (Enhanced) - 验证方式：打开文件后看右下角是否显示
Tcl (Enhanced)；若仍显示Tcl，检查 YAML 缩进是否错位、字段名是否拼错（比如写成file_extension少了s）
最易被忽略的是语法文件的 YAML 格式容错极低——一个缩进错误或冒号后少空格，整个语法包就静默失效；而构建系统里路径写错一个字符，tclsh 就永远 command not found。这两处没报错，只默默不工作，得靠手动验证每一步输出才看得见问题。
