需安装TypeScript、配置tsconfig.json、编写编译TS文件、HTML引用生成JS、启用tsc监听：1. npm install --save-dev typescript并tsc --init；2. 设outDir、target、module；3. src/main.ts编译至dist/main.js；4. HTML用type="module"引用；5. tsc --watch自动编译。
如果您正在开发HTML5项目并希望使用TypeScript增强代码的类型安全与可维护性，则需将TypeScript源文件编译为浏览器可执行的JavaScript，并在HTML中正确引用生成的脚本。以下是实现HTML5项目集成TypeScript编译与引用的具体步骤：
一、安装TypeScript编译器
TypeScript需要通过tsc命令行工具将.ts文件编译为.js文件，因此必须先在项目环境中安装TypeScript作为开发依赖。
1、打开终端或命令提示符，进入项目根目录。
2、执行命令：npm install --save-dev typescript。
立即学习“前端免费学习笔记（深入）”；
3、运行npx tsc --init生成tsconfig.json配置文件，用于控制编译行为。
二、配置tsconfig.json编译选项
tsconfig.json决定了TypeScript如何将源码转换为兼容目标环境的JavaScript，尤其需确保输出路径与模块格式适配HTML5项目的运行方式。
1、在tsconfig.json中设置"outDir": "./dist"，指定编译后JS文件输出到dist目录。
2、设置"target": "ES2017"或更高版本以支持现代浏览器特性，避免不必要的polyfill。
3、将"module": "ESNext"，确保模块语法与HTML中<script type="module">兼容。</script>
三、编写并编译TypeScript源文件
在src目录下编写.ts文件，经编译后生成对应.js文件，供HTML直接加载。编译过程需确保输出文件路径明确且无语法错误。
1、在项目中创建src目录，并添加main.ts文件，例如：console.log("Hello from TypeScript!");。
2、执行命令：npx tsc，触发编译，生成dist/main.js。
3、检查dist目录是否存在main.js，且内容为合法JavaScript语句。
四、在HTML中引用编译后的JavaScript
HTML页面不能直接加载.ts文件，必须引用tsc生成的.js文件。根据模块系统选择对应script标签类型，确保执行时机与依赖关系正确。
1、在index.html的
内添加：<script type="module" src="./dist/main.js"></script>。2、若未使用ES模块，改为：<script src="./dist/main.js"></script>，并确保main.ts中无export语句。
3、确认HTML文件与dist目录处于同一级路径结构，或按实际相对路径调整src属性值。
五、启用自动编译监听模式
开发过程中频繁手动执行tsc效率低下，启用监听模式可在.ts文件保存时自动重新编译，提升迭代速度。
1、在终端中运行：npx tsc --watch，启动持续编译进程。
2、修改src/main.ts并保存，观察终端输出是否显示Found 0 errors. Watching for file changes.。
3、刷新HTML页面，验证控制台是否输出更新后的日志内容。
