VSCode中Solidity自动补全和格式化失效，根本原因是文件未被识别为Solidity语言：右下角显示“Plain Text”或“Unknown”时，所有功能静默失效；需手动切换语言模式、配置files.associations映射.sol后缀、安装Juan Blanco的Solidity扩展，并搭配prettier-plugin-solidity指定默认格式化器。
VSCode 里 Solidity 自动补全和格式化默认不生效，不是插件没装，而是语言模式没切对、文件关联没配好、或格式化工具没绑定——三者缺一不可。
为什么按 Ctrl+Space 没反应，或者补全项全是 JavaScript 的？
根本原因是 VSCode 当前没把 .sol 文件识别为 Solidity 语言。右下角状态栏显示 “Plain Text” 或 “Unknown” 时，所有插件功能（包括补全、高亮、跳转）全部静默失效。
- 点击右下角语言标识（比如 “Plain Text”），在弹出菜单中手动选 Solidity（注意：不是
Solidity (Beta)或Solidity Language Server） - 若列表里没有
Solidity，检查插件是否已安装且启用：搜索扩展 “Solidity”，作者必须是Juan Blanco，版本 ≥0.0.137（旧版有语言服务器崩溃问题） - 顺手在设置里搜
files.associations，添加一行："*.sol": "solidity"，避免每次打开都要点选
自动补全能用，但 IERC20 跳不到定义，或 msg.sender 不提示？
这是插件没连上语言服务器，或项目缺少依赖合约路径。官方 solidity-extension 依赖本地 node_modules 中的 OpenZeppelin 等包来提供语义补全。
- 确保项目根目录有
package.json，且已安装 OpenZeppelin：npm install @openzeppelin/contracts - 检查
hardhat.config.js是否配置了paths，例如：paths: { sources: "./contracts" } - 重启 VSCode 或执行命令
Developer: Restart Language Server（Ctrl+Shift+P 输入） - 补全 SPDX 行：在
.sol文件首行按Ctrl+Space，会直接提示// SPDX-License-Identifier: MIT，回车即可
格式化快捷键（Shift+Alt+F）没反应，或报错 “No formatter installed for ‘solidity’”？
VSCode 默认不带 Solidity 格式化器，需要额外安装并显式指定。Prettier 本身不支持 Solidity，必须用专用工具。
- 推荐安装
Prettier插件 +Solhint或prettier-plugin-solidity（后者更主流） - 运行：
npm install --save-dev prettier prettier-plugin-solidity - 在项目根目录加
.prettierrc文件，内容为：{"plugins": ["prettier-plugin-solidity"]} - 设置里搜
solidity format，确认 “Default Formatter” 已设为esbenp.prettier-vscode - 验证：打开
.sol文件，保存时应自动格式化；若仍无效，右键 → “Format Document With…” 手动选 Prettier
最容易被忽略的是：格式化只在语言模式为 Solidity 且文件关联正确时才触发——哪怕你装了 prettier-plugin-solidity，右下角还是 “Plain Text”，它就完全不会动。
