VSCode配置Solidity需三步同步生效：手动切换语言模式为Solidity、显式配置solc编译器路径、每个.sol文件首行添加严格格式的SPDX声明，缺一即导致高亮失效或编译失败。
VSCode 本身不运行 Solidity 合约，它只编辑、高亮、跳转；真正编译和执行靠 solc、Hardhat 或 Foundry —— 配置断在任一环，都会出现“文件白底黑字”“保存没反应”“npx hardhat compile 报错”。
右下角显示 “Plain Text” 怎么办
这不是插件没装，是 VSCode 根本没把 .sol 当 Solidity 处理。现象包括：F12 跳转失效、payable 关键字无颜色、补全不弹出。
- 打开任意
.sol文件，点击右下角语言标识（比如显示 “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输出；无任何反应 = 路径仍无效
npx hardhat compile 报 SPDX license identifier not provided
这是 Solidity ≥ 0.6.8 的硬性编译失败项，不是警告。VSCode 插件不会自动补全，也不会跳过 —— 少一个文件，整个命令就中断。
- 每个
.sol文件**第一行**必须是严格格式的 SPDX 声明：// SPDX-License-Identifier: MIT - 不能写成
/* */块注释，不能空行隔开，不能有任何前置空格或 BOM 字符 - 可用值仅限：
MIT、Apache-2.0、Unlicense；写GPL-3.0或none也会失败 - OpenZeppelin 合约自带 SPDX，但你自己写的
contracts/MyToken.sol必须单独加 - 快捷补全：光标定位到文件首行，按
Ctrl+Space触发提示，选中即可插入
npx hardhat 报 Cannot find module 'hardhat'
这不是没装 Hardhat，是 Node.js 模块作用域错了 —— 全局安装 npm install -g hardhat 在 VSCode 里基本不可用。
- 必须在项目根目录下操作：先
npm init -y初始化package.json，再npm install --save-dev hardhat（注意是--save-dev，不是-g） - 验证是否装对：进项目目录，运行
npx hardhat，应输出任务列表；若报错，检查当前目录下是否有package.json和node_modules/hardhat/ - VSCode 集成终端默认工作路径可能不是项目根目录，启动前先
cd进去，或右键项目文件夹 →Open in Integrated Terminal
真正麻烦的从来不是“怎么装”，而是插件、solc、hardhat、foundry 各自维护自己的路径、版本和作用域。它们之间不自动同步，出问题时得挨个验证：VSCode 是否识别语言、solc 路径是否可执行、hardhat 是否本地安装、SPDX 是否每份合约都严格满足 —— 少一个，就卡住。
