Sublime Text 3配置TypeScript React (TSX) 语法开发的教程

浅晨酱_7014

浅晨酱_7014

2026-08-01

516人浏览

原创

sublime text 3 支持 tsx 开发需同时满足三条件:绑定 .tsx 语法为 typescriptreact、配置 tsserver_path 指向本地 ./node_modules/typescript/lib/tsserver.js、添加 tsserver_options:["--project","."] 启用完整项目模式;缺一即导致高亮失效、jsx 报错、跳转失败。

sublime text 3配置typescript react (tsx) 语法开发的教程

Sublime Text 3 能跑 TSX,但默认完全不工作——不是插件没装,而是语法没绑、tsserver 没连、JSX 模式没开,三者缺一不可。

为什么 .tsx 文件打开就是 Plain Text 或标红?

Sublime Text 3 不会自动把 .tsx 当作 TypeScript + JSX 处理。即使装了插件,右下角显示 “Plain Text” 或 “JavaScript”,说明语法层就断了,后续所有语言功能(跳转、补全、类型提示)全失效。

  • 先打开任意 .tsx 文件,点击右下角当前语法名(比如 “Plain Text”)
  • 选 TypeScriptReact(注意大小写和空格,不是 TypeScript 或 JavaScript (Babel))
  • 如果列表里根本没有 TypeScriptReact,说明插件未加载:检查 Package Control → List Packages 是否有 TypeScript-Sublime-Plugin 或 LSP-typescript;再确认插件目录下存在 typescriptreact.sublime-syntax 或 Tsx.tmLanguage
  • ST3 用户必须额外安装 TypeScriptSyntax 包,否则 source.tsx 作用域不存在,JSX 展开时仍输出 class 而非 className

为什么 JSX 属性报错、Promise 找不到、tsconfig.json 像没读?

插件自带的 tsserver 是旧版,不解析你项目的 tsconfig.json,也不识别 "jsx": "react"、"lib": ["ES2020", "DOM"] 等配置。

react-pro
react-pro

你是一位 React 专家,擅长高级 Hook、性能优化、状态管理和现代 React 模式。适用场景:高级 Hook 模式...

下载
  • 在 Preferences → Package Settings → TypeScript → Settings(或 LSP → Settings)中填入:
{
  "tsserver_path": "./node_modules/typescript/lib/tsserver.js",
  "tsserver_options": ["--project", "."]
}
  • tsserver_path 必须以 ./ 开头,否则 Sublime 无法定位到项目级 node_modules
  • --project . 强制启用完整项目模式,否则 paths 别名、types 引入、JSX 编译选项全被忽略
  • 改完配置后必须执行 TS: Restart Server(Ctrl+Shift+P 输入),不能只重启 Sublime
  • 为什么 Ctrl+Click 跳转失败或跳到空白 .d.ts?

    跳转依赖 tsserver 的语义索引,而它只处理已保存的物理文件,并且对路径和类型定义敏感。

    • 确保光标停在有效标识符上(不能在字符串、注释、空格或 JSX 属性值里)
    • 文件必须已保存——未保存的缓冲区内容不会被 tsserver 索引
    • 跳转到 .d.ts 显示空白,大概率是缺少对应类型包,检查 node_modules/@types/ 是否存在,或运行 npm install --save-dev @types/react @types/react-dom
    • 若用 paths 别名,仅配 baseUrl 不够,必须靠 "tsserver_options": ["--project", "."] 触发完整解析

    TSX 配置最容易被忽略的三个点

    很多人卡在最后一步:语法高亮有了、tsserver 也连上了,但 JSX 还是标红或属性补全不对。

    • tsconfig.json 中必须明确写 "jsx": "react" 或 "jsx": "preserve",插件不会 fallback 推断
    • 别混用插件:TypeScript-Sublime-Plugin(ms-vscode 官方老版)自带过时内嵌 tsserver,和 LSP-typecript 冲突,建议卸载
    • ST3 用户若用 Package Control 安装插件,务必确认插件目录路径正确(如 %APPDATA%\Sublime Text 3\Packages\),Git 克隆进错目录会导致插件静默失效

    相关文章

    PHP速学视频免费教程(入门到精通)
    PHP速学视频免费教程(入门到精通)

    PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

    下载

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    TypeScript工程化开发与Vite构建优化实践
    TypeScript工程化开发与Vite构建优化实践

    本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

    2026.02.13

    292

    17

    TypeScript全栈项目架构与接口规范设计
    TypeScript全栈项目架构与接口规范设计

    本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

    2026.02.25

    500

    17

    TypeScript类型系统进阶与大型前端项目实践
    TypeScript类型系统进阶与大型前端项目实践

    本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

    2026.03.13

    371

    19

    TypeScript 全栈开发进阶指南
    TypeScript 全栈开发进阶指南

    面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

    2026.06.03

    286

    29

    TypeScript Node.js 全栈工程化与Monorepo架构实践
    TypeScript Node.js 全栈工程化与Monorepo架构实践

    本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

    2026.06.16

    618

    8

    OpenJDK JVM参数怎么调优
    OpenJDK JVM参数怎么调优

    Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

    2026.10.16

    100

    10

    OpenJDK怎么配置Java开发环境
    OpenJDK怎么配置Java开发环境

    怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

    2026.10.16

    60

    10

    OpenJDK怎么部署Java应用
    OpenJDK怎么部署Java应用

    Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

    2026.10.16

    40

    10

    Revel框架模板渲染与表单验证
    Revel框架模板渲染与表单验证

    本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

    2026.10.16

    40

    15

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程