Solidity文件无语法高亮需手动设置语言模式为Solidity，并配置files.associations；Hardhat需本地安装且在项目根目录执行；每个.sol文件首行必须添加SPDX许可证声明；编译须通过npx hardhat compile或VSCode任务触发。
安装 Solidity 插件后合约文件没语法高亮？
VSCode 默认不识别 .sol 文件，装了插件但没反应，大概率是文件关联没生效。Solidity 官方插件（Juan Blanco 提供）需要手动触发语言模式切换。
- 打开任意
.sol文件，右下角状态栏会显示当前语言（比如 “Plain Text”），点击它 - 在弹出菜单中搜索并选择
Solidity，不是Solidity (Beta)或其他变体 - 如果列表里没有
Solidity，说明插件没正确启用：检查插件是否已启用、VSCode 是否重启过、插件版本是否 >= 0.0.137（旧版有语言服务器崩溃问题） - 顺手在设置里搜
files.associations，加一条："*.sol": "solidity"，避免每次手动切
Hardhat 初始化失败，报错 Cannot find module 'hardhat'
这是 Node.js 模块作用域问题，不是没装 Hardhat，而是没在项目根目录下执行命令。Hardhat 要求每个合约项目都是独立的 npm 包，且 hardhat 必须作为本地依赖安装。
- 别用
npm install -g hardhat—— 全局安装会导致路径和版本混乱，VSCode 的终端可能找不到本地node_modules/.bin下的可执行文件 - 进到你的合约文件夹（比如
my-contract/），先运行npm init -y，再运行npm install --save-dev hardhat - 验证是否装对：执行
npx hardhat，应该列出任务列表；如果报错，检查当前目录下是否有package.json和node_modules/hardhat/ - VSCode 终端默认工作目录可能不是项目根，启动前手动
cd进去，或右键文件夹 → “Open in Integrated Terminal”
编译时报错 SPDX license identifier not provided
这是 Solidity 0.6.8+ 强制要求，不是警告，是硬性编译失败项。Hardhat 默认启用严格检查，而很多教程代码漏写了许可证声明。
- 在每个
.sol文件最顶部（注释之前不能有任何空行或字符）加一行：// SPDX-License-Identifier: MIT - 可选值只有几个：
MIT、Apache-2.0、Unlicense，别写ISC或自定义字符串，否则照样报错 - 如果用 OpenZeppelin 合约，它们自带 SPDX，但你自己的
contracts/MyToken.sol必须自己加 —— 少一个文件，整个npx hardhat compile就中断 - VSCode Solidity 插件能自动补全这行，按
Ctrl+Space在文件首行触发提示即可
VSCode 里点“编译”没反应，或者找不到 hardhat compile 命令
VSCode 本身不内置 Solidity 编译功能，所谓“点编译”其实是靠插件调用终端命令。没反应 = 插件没绑定好命令，或终端环境不对。
- 别依赖右键菜单里的“Compile Solidity File”——这个功能来自旧版插件，新版已移除；正确做法是用 VSCode 的 Tasks 或直接终端运行
- 推荐方案：按
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选hardhat: compile（前提是项目里已配置好.vscode/tasks.json） - 快速配置 task：在项目根建
.vscode/tasks.json，内容为{ "version": "2.0.0", "tasks": [ { "label": "hardhat: compile", "type": "shell", "command": "npx hardhat compile", "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false } } ] } - 注意：如果项目用了 pnpm 或 yarn，把
npx换成pnpm exec或yarn hardhat，否则命令找不到
artifacts/，不是 build/ 或 out/，这点和 Truffle 不同；另外，每次改完合约，必须手动重新运行 hardhat compile，没有文件监听自动编译 —— 别等它自己热更。 
