code命令找不到的根源是cli未注册：先运行which code（macos/linux）或where code（windows）验证是否在path中，无输出即未注册；需在vscode中执行shell command: install 'code' command in path并重启终端。
code 命令找不到：先确认 CLI 是否注册成功
离线或新装 VSCode 后，code --install-extension 报 command not found，不是插件问题，而是 shell 根本不认识 code 这个命令。
运行 which code（macOS/Linux）或 where code（Windows）验证是否在 PATH 中。无输出即未注册。
- macOS：打开 VSCode →
Cmd+Shift+P→ 输入Shell Command: Install 'code' command in PATH并执行 - Windows：同样用
Ctrl+Shift+P触发该命令；若失败，检查是否以管理员身份运行过安装程序 - Linux（.deb 包）：默认不写入
/usr/bin到用户 PATH，需手动将/usr/bin加入~/.bashrc或~/.zshrc
切记不要用 sudo code --install-extension，否则插件会装进 /root/.vscode/extensions/，普通用户启动 VSCode 后完全不可见。
npm install 报 FetchError 或权限拒绝：改缓存路径 + 权限对齐
VSCode 终端里执行 npm install 卡在 FetchError: Invalid response body while trying to fetch https://registry...，本质是 npm 尝试访问网络但被拦截（比如离线、代理异常、镜像源失效），或缓存目录权限错乱。
更隐蔽的问题是：你改过 npm 全局路径，但没同步更新环境变量，导致 VSCode 终端里的 npm 和系统终端行为不一致。
- 先查当前配置：
npm config get prefix和npm config get cache - 确保
prefix指向你有写权限的目录（如D:\NodeJS\node_global），且该路径已加入系统PATH - 缓存目录（
cache）也必须可写；右键打开node_cache文件夹 → 属性 → 安全 → 编辑当前用户权限，勾选“完全控制” - 国内环境建议配镜像源：
npm config set registry https://pypi.tuna.tsinghua.edu.cn/simple/（注意这是 pip 的，npm 应用https://registry.npmmirror.com）
Python 依赖装了却 import 报错：解释器、终端、虚拟环境三者脱节
状态栏显示 Python 3.11.9 ('venv')，但运行脚本仍报 ModuleNotFoundError，说明 VSCode 认的解释器和终端实际激活的环境不是同一个。
关键检查点有三个：解释器路径设置、终端是否自动激活、虚拟环境命名是否合规。
- 打开
settings.json，确认python.defaultInterpreterPath指向venv/bin/python（macOS/Linux）或venv\Scripts\python.exe（Windows） - 检查
python.terminal.activateEnvironment是否为true；设为false会导致终端永远不激活 venv - 虚拟环境目录名必须是
.venv、venv、env或ENV之一，否则 VSCode 不识别 - 在集成终端中运行
which python（macOS/Linux）或where python（Windows），输出路径必须与defaultInterpreterPath严格一致
ESLint / Pylint 自动修复不生效：开关没开 + 本地包没加载
装了 ESLint 插件，保存文件却不自动修复，常见原因是两个开关没打开，或 VSCode 找不到项目级的 eslint 可执行文件。
它不会因为你装了插件就自动调用 eslint --fix，必须显式声明“保存时干这事”，且得能定位到正确的 eslint 二进制。
- 启用自动修复：在
settings.json中加"editor.codeActionsOnSave": {"source.fixAll.eslint": true} - 指定包管理器：设
eslint.packageManager为npm或pnpm，否则默认走全局eslint - 右下角 ESLint 图标点开，若显示
Using globally installed ESLint，说明没读到node_modules/.bin/eslint，需重启窗口或执行Developer: Reload Window - 确保项目根目录有
package.json且已运行npm install（或pnpm install）
最常被忽略的是：VSCode 的终端和编辑器用的是同一套 Python 解释器，但 npm / eslint / pip 这些工具链各自认自己的环境变量和 PATH，它们之间没有自动同步机制。配错一层，整条链就断。
