在VSCode中用// @ts-check检查JS时，如何解决HTMLElement无width属性错误？

你遇到的问题其实是编辑器（比如VS Code）默认启用了TypeScript的语言服务来检查JavaScript代码导致的——虽然你写的是纯JS，但TS的类型检查逻辑会自动生效，所以会报Property 'width' does not exist on type 'HTMLElement'这类TS风格的错误。下面给你几个适合纯JS项目的解决办法：

方法1：给元素添加类型注释（推荐） #

这个方法不是忽略错误，而是明确告诉编辑器元素的具体类型，既消除错误还能获得更好的代码提示。比如你操作的是图片元素（width是<img>的原生属性，通用HTMLElement类型确实没有这个属性），可以这样写：

/** @type {HTMLImageElement} */
const targetElement = document.getElementById('your-element-id');
const elementWidth = targetElement.width;

如果是其他元素（比如canvas），就把HTMLImageElement换成对应的类型，比如HTMLCanvasElement、HTMLDivElement等。

方法2：临时忽略单个错误 #

如果只是想快速消除某一行的错误，可以用TS的注释指令// @ts-ignore，放在报错代码的上一行：

// @ts-ignore 忽略HTMLElement类型检查
const elementWidth = document.getElementById('your-element-id').width;

⚠️ 注意：这个方法只是临时屏蔽错误，不会解决类型问题，尽量少用，避免掩盖真正的代码问题。

方法3：关闭整个项目的JS类型检查 #

如果你完全不需要TS的类型检查功能，可以全局关闭：

• VS Code编辑器设置：打开设置面板（快捷键Ctrl+,），搜索javascript.implicitProjectConfig.checkJs，把选项设为false。
• 项目配置文件：在项目根目录创建jsconfig.json文件，写入以下内容：

{
  "compilerOptions": {
    "checkJs": false
  }
}

这样整个项目的JS文件就不会再触发TS类型检查了。

关于你提到的// @ts-...未完成报错的问题 #

你输入的// @ts-c是不完整的TS指令，编辑器无法识别，所以会出现额外的提示。要使用这类指令，必须写完整的内容，比如// @ts-ignore、// @ts-expect-error等，写完后错误就会消失。

内容的提问来源于stack exchange，提问作者user8555599