VSCode本身不运行Solidity合约，仅编辑、高亮、跳转；真正编译执行依赖solc、Hardhat或Forge。常见失败原因有三：语言模式未切为Solidity（右下角显示“Plain Text”需手动选择或配置"files.associations"）、Hardhat未本地安装（须在项目根目录执行npm install --save-dev hardhat）、每个.sol文件首行缺失严格格式SPDX声明（如// SPDX-License-Identifier: MIT）。
VSCode 本身不运行 Solidity 合约，它只编辑、高亮、跳转；真正编译、部署、执行靠的是 solc、hardhat 或 forge 这类外部工具。你看到“运行失败”，90% 是卡在这三处：语言模式没切对、Hardhat 没本地装、.sol 文件缺 SPDX 声明。
右下角显示 “Plain Text” 怎么办
这不是插件没装，是 VSCode 根本没把 .sol 当 Solidity 处理——高亮、F12 跳转、payable 关键字变色全失效。
- 打开任意
.sol文件，点击右下角状态栏（比如显示 “Plain Text”） - 在弹出菜单中搜索并选
Solidity（不是Solidity (Beta)或其他变体） - 若列表里没有
Solidity，检查插件是否启用、VSCode 是否重启、插件版本是否 ≥0.0.137 - 一劳永逸：在设置里搜
files.associations，加一行："*.sol": "solidity"
npx hardhat compile 报 Cannot find module 'hardhat'
这不是没装 Hardhat，而是装错了作用域——npm install -g hardhat 在 VSCode 集成终端里基本无效，npx 找不到项目级 node_modules/.bin/hardhat。
- 必须进到项目根目录（如
my-contract/），再执行：npm init -y→npm install --save-dev hardhat - 验证：运行
npx hardhat，应输出任务列表；若失败，确认当前目录下有package.json和node_modules/hardhat/ - VSCode 终端默认工作路径常不是项目根目录，启动前右键项目文件夹 → “Open in Integrated Terminal”，别靠记忆
cd
编译总报 SPDX license identifier not provided
这是 Solidity ≥ 0.6.8 的硬性编译失败项，不是警告。Hardhat 默认开启严格检查，少一个文件，整个 npx hardhat compile 就中断。
- 每个
.sol文件第一行必须是：// SPDX-License-Identifier: MIT - 不能写在
pragma solidity ^0.8.20;后面，不能空行隔开，不能有任何前置空格或 BOM 字符 - 可用值仅限：
MIT、Apache-2.0、Unlicense；写none、GPL-3.0或大小写错误都会失败 - OpenZeppelin 的
@openzeppelin/contracts自带 SPDX，但你自己写的contracts/MyToken.sol必须手加 - 快捷补全：光标定位到文件首行，按
Ctrl+Space触发提示，选中即可插入
保存后没反应，也不报错，就是不编译
这说明插件没调起 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输出；无任何反应 = 路径仍无效
最容易被忽略的是：SPDX 声明必须紧贴文件开头，连空行都不能有；还有就是 VSCode 终端的工作目录，很多人反复重装插件却没意识到终端根本没进对文件夹。
