vscode本身不运行foundry，仅提供编辑支持；真正执行forge build、test等操作的是终端cli工具，配置失败主因是语言模式未切为solidity、forge未入path或tasks.json未正确配置任务。
VSCode 本身不运行 Foundry，只提供编辑支持；真正执行 forge build、forge test、anvil 的是终端里的 CLI 工具。配置错位会导致“右下角显示 Solidity，但保存无反应”“forge test 报 command not found”“点击测试按钮没反应”。
VSCode 显示 “Plain Text” 而不是 Solidity 语言模式
这是最常被跳过的一步：VSCode 默认不识别 .sol 文件，哪怕插件已安装。现象包括 F12 跳转失效、payable 关键字无颜色、右下角状态栏写 “Plain Text”。
- 手动点击右下角语言标识 → 搜索并选中
Solidity（注意不是Solidity (Beta)） - 若列表里没有
Solidity，检查插件是否启用、VSCode 是否重启、插件版本是否 ≥0.0.137（旧版在 0.8.20+ 合约中易崩溃） - 一劳永逸：在 VSCode 设置中搜索
files.associations，添加："*.sol": "solidity"
forge build 或 anvil 命令找不到
Foundry 不是 VSCode 插件，它是一套独立的 Rust CLI 工具链。VSCode 只负责调用它们 —— 所以必须确保命令能在终端中直接执行，否则所有集成功能都会失效。
- macOS/Linux：用
brew tap foundry-rs/foundry && brew install foundry安装，然后在 VSCode 终端运行forge --version验证 - Windows：推荐使用
choco install foundry（比 WSL 更稳定），避免从源码编译导致路径混乱 - 验证失败？检查终端是否为 Git Bash / PowerShell / CMD —— VSCode 默认终端类型会影响 PATH 加载；可在 VSCode 设置里搜
terminal integrated default profile切换 - 别依赖 “Foundry for VSCode” 插件来安装工具链，它只是任务快捷入口，不带二进制
想在 VSCode 里一键运行 forge test 或启动 anvil
VSCode 支持把常用 CLI 封装成任务（Task），按 Ctrl+Shift+P → Tasks: Run Task 触发，比反复切终端更高效。
- 在项目根目录建
.vscode/tasks.json，内容示例：
{
"version": "2.0.0",
"tasks": [
{
"label": "forge: build",
"type": "shell",
"command": "forge",
"args": ["build"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"panel": "shared"
}
},
{
"label": "anvil: start",
"type": "shell",
"command": "anvil",
"args": ["--accounts", "10", "--balance", "100"],
"isBackground": true,
"problemMatcher": [],
"presentation": {
"echo": true,
"panel": "shared",
"showReuseMessage": true
}
}
]
}
-
isBackground: true表示后台运行（如anvil），否则任务会卡住直到进程退出 - 任务名（
label）会出现在命令面板里，建议带前缀便于区分 - 如果项目用了
foundry.toml，任务无需额外传参，forge会自动读取配置
测试通过但部署报 invalid opcode 或交易卡在 pending
这不是 VSCode 或插件的问题，而是 Foundry 默认用 Anvil 启动的链与你部署目标不一致 —— 特别是 EVM 兼容性、预编译地址、gas limit 等细节。
- 本地测试用
anvil，部署到 Sepolia/Arbitrum 等网络时，必须显式指定--rpc-url和--private-key，不能复用anvil的账户 - 常见坑：
forge create默认不验证合约构造函数参数，如果constructor(uint256)缺少传参，链上会 revert 成invalid opcode - 部署脚本里用
cast send或forge script时，记得加--legacy标志（部分测试网仍要求 legacy tx） - Anvil 默认 gas limit 是 30M，而主网分叉或某些 L2 可能更低，部署大合约前先
anvil --gas-limit 90000000
真正的难点不在配置步骤，而在于区分「VSCode 编辑行为」和「Foundry 运行时行为」——比如高亮正常 ≠ 编译通过，任务能触发 ≠ 链环境就绪，forge test 成功 ≠ 合约在目标链上可交互。每次出问题，先确认命令在纯终端里能否跑通，再查 VSCode 集成层。
