VSCode右下角显示“Plain Text”是因未识别.sol文件为Solidity语言，需手动切换语言模式或配置"files.associations": {"*.sol": "solidity"}；否则高亮、补全、编译均失效。
VSCode 本身不编译也不部署合约，它只是编辑器；真正干活的是 solc、Hardhat 或 Foundry —— 配置错位或路径断开，就会出现“高亮正常但保存无反应”“npx hardhat compile 报 SPDX 错误”“forge build 找不到命令”这类问题。
为什么 .sol 文件右下角显示 “Plain Text”？
这是最常被跳过的一步：VSCode 默认不把 .sol 当 Solidity 处理，哪怕插件已安装。现象包括 F12 跳转失效、payable 关键字无颜色、右下角状态栏写“Plain Text”。
- 手动点击右下角语言标识 → 搜索并选中
Solidity（注意不是Solidity (Beta)） - 若列表里没有
Solidity，检查插件是否启用、VSCode 是否重启、插件版本是否 ≥0.0.137（旧版在0.8.20+合约中易崩溃） - 一劳永逸：在 VSCode 设置中搜索
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输出；无任何反应 = 路径仍无效
Hardhat 项目里 npx hardhat compile 报 SPDX license identifier not provided？
这是 Solidity ≥ 0.6.8 的硬性编译失败项，不是警告。VSCode 插件不会自动补全，必须手动加在每个 .sol 文件最顶部。
- 首行必须严格为：
// SPDX-License-Identifier: MIT（注意前后空格、冒号、大小写） - 可用值仅限：
MIT、Apache-2.0、Unlicense；写GPL-3.0或自定义字符串也会失败 - OpenZeppelin 合约自带 SPDX，但你自己写的
contracts/MyToken.sol必须单独加 —— 少一个文件，整个npx hardhat compile就中断 - 快捷补全：光标定位到文件首行，按
Ctrl+Space触发提示，选中即可插入
VSCode 里点运行按钮没反应，或部署脚本报 command not found？
VSCode 不接管部署流程，它只负责写代码时不出错。部署必须走框架原生命令，且依赖终端当前工作目录和环境变量。
- 确保你在项目根目录（含
hardhat.config.js或foundry.toml）打开集成终端：Ctrl+`→cd进去，或右键文件夹 → “Open in Integrated Terminal” - Hardhat 项目：部署必须用
npx hardhat run scripts/deploy.js --network localhost，不是插件按钮 - Foundry 项目：部署用
forge script Script --rpc-url http://localhost:8545 --private-key ...，前提是forge在PATH中 - 插件检测到
hardhat.config.js后会主动禁用内置编译，所以别指望保存就自动 deploy —— 它的设计定位就是“辅助编写”，不是“替代 CLI”
真正麻烦的从来不是“怎么装”，而是 solc、hardhat、forge、VSCode 插件各自维护自己的路径、版本和作用域。它们之间不自动同步，出问题时得挨个验证：VSCode 是否识别了语言模式？插件是否读到了正确 solc 路径？Terminal 当前目录是否在项目根？package.json 里有没有本地安装 hardhat？少验一环，就卡在“看起来都对，但就是跑不通”。
