需依次安装VSCode、Solidity插件、本地solc编译器、Hardhat框架，并可选集成Foundry工具链，以完成macOS下Solidity开发环境搭建。
如果您希望在本地配置一个用于编写和调试 solidity 智能合约的开发环境，但尚未安装必要插件或工具链，则可能无法进行语法高亮、编译、部署或测试。以下是完成 vscode for solidity 开发环境搭建的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Visual Studio Code
VSCode 是 Solidity 开发的核心编辑器，需先确保其已正确安装并可正常启动。该步骤为后续所有插件与工具集成提供基础运行平台。
1、访问 code.visualstudio.com 官网，下载 macOS 版本安装包。
2、双击下载的 .zip 文件解压，将 VSCode 应用拖入 Applications 文件夹。
3、在 Launchpad 或 Finder 中打开 VSCode，验证是否显示欢迎界面且无崩溃提示。
二、安装 Solidity 插件
该插件提供语法高亮、智能补全、代码片段及错误实时检测功能，是编写 Solidity 合约的基础支持组件。
1、在 VSCode 中按下 Cmd+Shift+X 打开扩展市场。
2、在搜索框中输入 Solidity，选择作者为 Juan Blanco 的官方插件。
3、点击“Install”按钮完成安装，重启 VSCode 使插件生效。
三、配置本地 Solidity 编译器
本地编译器允许在不依赖在线服务的情况下对 .sol 文件执行编译检查，支持指定版本以匹配目标区块链的 EVM 兼容性要求。
1、在终端中执行 npm install -g solc 安装全局 Solidity 编译器。
2、运行 solcjs --version 验证安装结果，输出应包含类似 0.8.24+ 的版本号。
3、在 VSCode 设置中搜索 solidity.compileUsingRemoteVersion，将其设为 false，强制使用本地编译器。
四、集成 Hardhat 开发框架
Hardhat 提供本地测试网络、任务脚本、合约编译与部署命令行接口，是当前主流的 Solidity 工程化开发工具链。
1、在项目根目录执行 npm init -y 初始化 package.json。
2、运行 npm install --save-dev hardhat 安装 Hardhat 核心模块。
3、执行 npx hardhat，选择 Create a basic sample project，按提示完成初始化。
五、启用 Foundry 支持（替代方案）
Foundry 是基于 Rust 构建的高性能 Solidity 开发工具集，适用于偏好 CLI 驱动流程、快速测试与 fuzzing 的开发者。
1、通过 Homebrew 运行 brew tap foundry-rs/foundry && brew install foundry 安装 Foundry 工具链。
2、在终端中执行 forge init my-contract 创建新项目。
3、在 VSCode 中打开该项目文件夹，确认 remappings.txt 与 foundry.toml 文件存在且可读。
