必须手动绑定语法作用域：打开.sol文件后点击右下角状态栏→Open all with current extension as→Solidity；若无该选项，说明Ethereum插件未生效或未重启；Windows用户可加"default_encoding": "UTF-8"修复编码问题。
打开.sol文件显示Plain Text，不是插件没装，是语法作用域没绑定
Sublime不会自动把所有.sol文件识别为Solidity，哪怕你已安装Ethereum插件。右下角状态栏显示Plain Text或Python，就是典型症状。
- 点击右下角状态栏当前语法名 → 选择
Open all with current extension as→Solidity - 如果列表里没有
Solidity，说明插件未生效：确认安装的是Ethereum（Juan Blanco维护），不是SoliditySyntax或Solhint-sublime - Windows用户若仍不生效，可在
Preferences → Settings中加一行："default_encoding": "UTF-8"
Ctrl+B编译报'solc' is not recognized，本质是PATH没继承
Sublime启动时读取的是当时系统的PATH，不是你终端里能跑solc --version的那个环境。重启前装的solc，Sublime根本看不见。
- 先在终端执行
solc --version，确认命令可用；不可用就运行：solc-select install 0.8.24 && solc-select use 0.8.24 - 装完必须重启Sublime Text——环境变量不会热更新
- Build System中
"cmd"字段必须写绝对路径，例如Windows：["C:/Users/xxx/AppData/Roaming/npm/solc.cmd", "--combined-json", "abi,bin", "$file"] -
"working_dir": "$file_path"不能省，否则import "./Lib.sol"会因相对路径解析失败而报错
保存后没报错，但address payable或unchecked块不校验
语法高亮只是“颜色对”，不代表Sublime理解Solidity语义。要触发类型检查，得靠solc --validate，而这需要两个硬性前提。
- 本地
solc版本必须≥0.8.13（--validate参数从该版本引入） - 在
Preferences → Package Settings → SublimeEthereum → Settings中填入完整路径和版本：{"solc_path":"/usr/local/bin/solc", "solc_version":"0.8.24"} -
solc_path必须指向可执行文件（如/usr/local/bin/solc），不是目录；用which solc（macOS/Linux）或where solc（Windows）确认 - 若用
solc-select，solc_path应设为wrapper路径（如/usr/local/bin/solc），再靠solc_version指定具体版本
想补全msg.sender、require()却没提示
Ethereum插件只做语法高亮，不提供语义级补全。它不认识msg是全局对象，也不懂require是内置函数。
- 必须额外安装
SublimeCodeIntel或SublimeLinter类插件 -
SublimeCodeIntel需配合solc生成的AST或solc --ast-compact-json输出才能实现较准补全 - 纯高亮场景下，补全基本靠手敲+记忆，别指望
Ctrl+Space弹出block.timestamp
真正卡住人的从来不是“能不能高亮”，而是solc_path写错一字符、working_dir漏掉、或者solc_version和实际调用版本不一致——这些地方不报错，只默默失效。
