vscode是主流Solidity开发环境,搭配Solidity、Hardhat for VSCode、Prettier Solidity和eslint-plugin-solidity等插件,可实现语法高亮、编译、测试、调试及格式化全流程支持。

VSCode 是目前最主流的 Solidity 开发环境之一,轻量、插件丰富、调试体验好,特别适合以太坊智能合约的编写、编译、测试和部署全流程。
必备插件:让 VSCode 真正支持 Solidity
安装以下核心插件后,VSCode 就能提供语法高亮、自动补全、格式化、错误提示等关键能力:
- Solidity(Juan Blanco 开发)——最成熟稳定的 Solidity 语言支持,支持 0.4.x 到最新 0.8.x+ 版本,自动识别 pragma、接口、事件等结构
- Hardhat for VSCode(Nomic Foundation 官方推荐)——一键运行 Hardhat 任务(如 compile、test、run)、跳转到任务定义、查看控制台日志
- Prettier + Prettier Solidity——统一代码风格,避免团队协作时的格式争议;配置好后保存即自动格式化
- ESLint + eslint-plugin-solidity——静态检查潜在风险(如 unchecked math、重入漏洞提示、未使用的变量)
项目初始化:从 Hardhat 入手最稳妥
不建议手动搭环境。用 Hardhat 初始化项目,天然兼容 VSCode 插件:
- 终端执行
npx hardhat,选择 “Create a basic sample project” - 生成的
contracts/、test/、scripts/目录会被 Solidity 插件自动识别 - 打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输入 “Hardhat: Compile” 即可一键编译,错误直接标在代码行号旁
- 右键点击
.sol文件 → “Solidity: format Document” 可快速美化代码
调试与测试:在 VSCode 里像写前端一样查问题
借助 Hardhat Network 和 VSCode 的调试器,可以单步执行合约函数、查看内存/存储变化:
- 在
test/中写好测试用例(用hardhat-ethers或waffle),右键 → “Hardhat: Run Test” 查看详细输出 - 在
scripts/中写部署脚本,按 F5 启动调试(需配置.vscode/launch.json使用 Hardhat 调试器) - 在合约函数内打断点(如
require前),运行脚本后可停在 Solidity 行,观察msg.sender、参数值、storage 变量等
进阶技巧:提升日常开发效率
几个小但实用的习惯,能明显减少重复操作:
- 把常用 Hardhat 命令绑定为 VSCode 任务(
.vscode/tasks.json),比如一键测试 + 清缓存 + 重新编译 - 用
remappings.txt管理 OpenZeppelin 等依赖路径,Solidity 插件会自动解析,跳转和补全更准 - 开启
"solidity.compileUsingRemoteVersion": "latest"(在 settings.json 中),避免本地 solc 版本混乱 - 对复杂合约,右键 → “Solidity: Generate ABI” 快速导出 ABI 文件,方便前端调用或部署验证
基本上就这些。VSCode 搭配 Hardhat 和几个关键插件,已经覆盖了从写第一行 pragma solidity ^0.8.20; 到上线主网前的所有高频需求。不复杂但容易忽略的是插件版本匹配和 Hardhat 配置同步——保持它们和你用的 Solidity 版本一致,能省下大量排错时间。