Web3.js 1.x 不再内置 Solidity 编译功能，必须用外部 solc 编译器；需严格匹配 pragma 版本、Node.js v14+、正确提取 ABI 数组和带 0x 前缀的 bytecode，并用 HttpProvider 正确连接本地节点。
Web3.js 1.x 版本必须手动集成 solc 编译器，不能用 web3.eth.compile.solidity() —— 这个 API 在 1.0 beta 后就彻底移除了，硬写会报 TypeError: web3.eth.compile is not a function。
为什么 npm install web3 后还是无法编译 Solidity？
因为 Web3.js 自 1.0 起剥离了所有编译能力，只负责与链交互。编译必须交给 solc 或 Remix 等外部工具完成。
-
solc版本要严格匹配合约 pragma，比如pragma solidity ^0.8.0就得用solc@0.8.26，混用0.7.x会触发ParsingError - Node.js v14+ 是硬性要求，v12 下
solc.compile()可能返回空对象（output.contracts为undefined） - Windows 用户注意：Git Bash 中运行
node compile.js比 PowerShell 更稳定，后者偶尔因路径分隔符导致fs.readFileSync报ENOENT
如何在 VSCode 里正确加载 ABI 和 bytecode？
ABI 必须是纯数组格式，不是整个 .json 文件内容；bytecode 必须带 0x 前缀，且不能含换行或空格 —— 否则 web3.eth.Contract 构造时直接抛 Error: Invalid JSON ABI 或 invalid bytecode。
- 从 Foundry 的
out/Counter.sol/Counter.json提取 ABI 时，只复制"abi"字段值（即方括号开头的数组），别连带"bytecode"或"deployedBytecode" - Hardhat 编译后 bytecode 在
artifacts/contracts/MyContract.sol/MyContract.json的bytecode.object字段，记得手动加0x - VSCode 中建议装
Solidity插件（Juan Blanco 版），它右键菜单有 “Copy ABI” 和 “Copy Contract Address”，比手动找快得多
连接 Ganache 或 Anvil 时常见 Provider 错误
web3.setProvider() 已废弃，新版必须用 new Web3(new Web3.providers.HttpProvider(...))；且 URL 末尾不能带斜杠，http://localhost:8545/ 会导致 Invalid response from RPC server。
- Ganache 默认端口是
8545，Anvil 默认是8545（不是3030或7545），启动时没改过就别猜端口 - 如果用 MetaMask 注入的
window.ethereum，必须先await ethereum.request({ method: 'eth_requestAccounts' })，否则web3.eth.getAccounts()返回空数组 - 本地测试网账户余额为 0？检查 Ganache 是否启用了 “Auto-mining”，Anvil 要加
--block-time 1才能自动出块
ABI 格式错一个逗号、bytecode 少一个 0x、Provider URL 多一个斜杠——这些地方看着小，但 Web3.js 不会给你友好提示，只会静默失败或抛泛型错误。动手前先用 console.log(abi) 和 console.log(bytecode) 对着原始 JSON 手动核对两遍。
