VSCode配置Solidity开发需三步同步生效：手动切换语言模式为Solidity、显式配置solc编译器路径、每个.sol文件首行严格添加SPDX声明，缺一即导致高亮失效或编译失败。
VSCode 本身不运行 Solidity 代码，它只负责编辑和语法支持；真正执行编译、测试、部署的是 solc、hardhat 或 forge 这类命令行工具。配置失败的根源几乎总是：语言模式没切对、编译器路径没填准、SPDX 声明漏写——三者任意缺一，就会出现“高亮失效”“保存无反应”“npx hardhat compile 报错”等现象。
VSCode 右下角显示 “Plain Text” 怎么办
这不是插件没装好，是 VSCode 根本没把 .sol 文件当 Solidity 处理。即使装了 Juan Blanco 的 Solidity 插件，也得手动绑定文件类型。
- 打开任意
.sol文件，点击右下角状态栏的语言标识（比如显示 “Plain Text”） - 在弹出菜单中搜索并选择 Solidity（注意不是
Solidity (Beta)或其他变体） - 若列表里没有
Solidity，检查插件是否启用、VSCode 是否重启、插件版本是否 ≥0.0.137（旧版在0.8.20+合约中易崩溃） - 为避免每次手动切，直接在设置里搜
files.associations，加一行："*.sol": "solidity"
solc not found 或保存后没输出
插件默认从系统 PATH 查找 solc，但绝大多数人没配过全局路径，结果就是高亮正常、编译静默失败。
- 别用
npm install -g solc：Windows 上生成.cmd包装器，插件常解析失败；macOS/Linux 下权限或符号链接也容易断裂 - 推荐用
solc-select管理版本：npm install -g solc-select→solc-select install 0.8.24→solc-select use 0.8.24 - 在 VSCode 设置中搜索
solidity compiler path，填入它生成的软链接路径：/usr/local/bin/solc（macOS/Linux）或C:\Users\XXX\AppData\Roaming\npm\solc.cmd（Windows） - 验证方式：保存一个
.sol文件，看输出面板是否有solc --version输出；无任何反应 = 路径仍无效
npx hardhat compile 报 “SPDX license identifier not provided”
这是 Solidity ≥ 0.6.8 的硬性编译失败项，不是警告。Hardhat 默认开启严格检查，而很多示例代码漏写了这行。
- 每个
.sol文件第一行必须是 SPDX 声明，例如：// SPDX-License-Identifier: MIT - 不能写在
pragma solidity后面，也不能空行隔开；必须紧贴文件开头 - 许可证 ID 必须是 SPDX 官方认可的：
MIT、Apache-2.0、Unlicense可用；// SPDX-License-Identifier: none不合法 - VSCode 的 Solidity 插件不会自动补全这行——它只校验，不修复。哪怕多一个 BOM 字符或不可见空格，都可能导致识别失败
最容易被忽略的其实是项目上下文：VSCode 插件会检测是否存在 hardhat.config.js 或 foundry.toml，一旦发现，就默认禁用内置编译流程，只做语法检查和跳转。这时候你点保存、按 Ctrl+S，什么都不会发生——这不是 bug，是设计。该用 npx hardhat compile 就老实用终端跑，别指望编辑器替你执行框架命令。
