VS Code中.sol文件无语法高亮，因插件不自动接管文件类型；需手动在右下角状态栏选择Solidity语言模式，或在settings.json中配置"files.associations": {"*.sol": "solidity"}。
VS Code 能跑 Solidity，但默认装完就写不了合约——缺语言识别、缺编译器、缺框架集成，三者少一个都会卡在 solidity 文件不亮、npx hardhat compile 报错、或者右下角显示 “Plain Text”。
为什么 .sol 文件没语法高亮
VS Code 不会自动把 .sol 当作 Solidity 文件处理，哪怕你已安装 Juan Blanco 的 Solidity 插件。插件只是提供能力，不自动接管文件类型。
- 打开任意
.sol文件，看右下角状态栏——如果显示Plain Text或JSON，说明语言模式没切对 - 点击该区域，在弹出菜单中手动选
Solidity（不是Solidity (Beta)或其他变体） - 为避免每次手动切，进 VS Code 设置搜
files.associations，加一行："*.sol": "solidity" - 旧版插件（
）有语言服务器崩溃问题，检查插件版本，过旧就更新
Hardhat 初始化失败：Cannot find module 'hardhat'
这不是没装 Hardhat，而是 Node.js 模块作用域错了——全局安装 npm install -g hardhat 在 VS Code 里基本不可用，终端找不到本地 node_modules/.bin 下的可执行文件。
- 必须在项目根目录下操作：先
npm init -y，再npm install --save-dev hardhat - 验证是否装对：进项目目录，运行
npx hardhat，应输出任务列表；若报错，检查当前目录下是否有package.json和node_modules/hardhat/ - VS Code 集成终端默认工作路径可能不是项目根目录，启动前先
cd进去，或右键项目文件夹 →Open in Integrated Terminal
编译报错 SPDX license identifier not provided
这是 Solidity 0.6.8+ 的硬性要求，不是警告，是编译失败项。Hardhat 默认启用严格检查，而很多示例代码漏了许可证声明。
- 每个
.sol文件第一行必须是 SPDX 声明，例如：// SPDX-License-Identifier: MIT - 不能写成
/* */块注释，必须是//行注释，且必须在文件最顶部（前面不能有空行或 BOM） - 许可证 ID 必须合法，
MIT、Apache-2.0、Unlicense可用；UNLICENSED仅限测试，部署到主网会被拒绝
最容易被忽略的是：SPDX 声明必须紧贴文件开头，连空行都不能有；还有就是 VS Code 终端的工作目录，很多人反复重装插件却没意识到终端根本没进对文件夹。
