vscode默认不识别.sol文件，需手动设置语言模式为solidity并配置files.associations；编译失败常因solc路径未配置或缺失spdx许可证声明，须在每份.sol文件首行严格添加// spdx-license-identifier: mit。
VSCode 默认完全不识别 .sol 文件，装插件只是起点，高亮和补全能工作 ≠ 编译能跑通 —— 这两者依赖完全不同的底层机制。
Solidity 插件启用后仍显示“Plain Text”
这是最常被忽略的第一步失败：插件已安装，但 VSCode 根本没把文件当 Solidity 处理。右下角状态栏显示“Plain Text”或“Unknown Language”，说明语言模式未绑定。
- 手动点击右下角语言标识 → 搜索并选择
Solidity（注意不是Solidity (Beta)或其他变体） - 若列表里没有
Solidity，检查插件是否启用、VSCode 是否重启、插件版本是否 ≥0.0.137（旧版存在语言服务器崩溃问题） - 一劳永逸：在 VSCode 设置中搜索
files.associations，添加项："*.sol": "solidity"
保存时弹出 solc not found 或 Command failed: solc --version
插件默认从系统 PATH 查找 solc，但绝大多数人没配过，导致“高亮正常、编译失灵”。这不是合约写错了，是路径根本没打通。
- 在 VSCode 设置中搜索
solidity compiler path，填入完整可执行路径：
macOS/Linux 示例：/usr/local/bin/solc；
Windows 示例：C:\Users\XXX\AppData\Roaming\npm\solc.cmd - 更稳妥方案：用
solc-select管理多版本，执行solc-select use 0.8.24后，填入它生成的软链接路径（通常是/usr/local/bin/solc） - 验证是否生效：保存一个
.sol文件，看输出面板是否有solc版本输出或编译错误；无任何反应 = 路径仍无效
Hardhat 编译报错 SPDX license identifier not provided
这不是警告，是 Solidity ≥ 0.6.8 的硬性编译失败项。VSCode 插件不会帮你加这行，必须手动写在每个 .sol 文件最顶部（注释前不能有任何空行或字符）。
- 标准写法（必须严格匹配）：
// SPDX-License-Identifier: MIT - 可用值仅限：
MIT、Apache-2.0、Unlicense；写GPL-3.0或自定义字符串也会失败 - VSCode 插件支持快捷补全：光标定位到文件首行，按
Ctrl+Space触发提示，选中即可插入 - 注意：OpenZeppelin 合约自带 SPDX，但你自己写的
contracts/MyToken.sol必须单独加 —— 少一个文件，整个npx hardhat compile就中断
真正麻烦的从来不是“怎么装”，而是多个工具链（插件、solc、hardhat、foundry）各自维护自己的路径、版本和作用域。它们之间不自动同步，出问题时得挨个验证：VSCode 是否认文件、solc 是否可执行、hardhat 是否在项目本地安装、当前终端是否在正确目录 —— 少一环，就卡住。
