如何在本地运行CodePen项目：MediaPipe人脸关键点检测的本地化实践

聖光之護

发布时间：2025-11-10 18:22:01

1070人浏览过

来源于php中文网

原创

如何在本地运行CodePen项目：MediaPipe人脸关键点检测的本地化实践

本文详细指导如何将codepen上的前端项目，特别是涉及外部库和模块的mediapipe人脸关键点检测项目，成功部署到本地运行。文章聚焦于解决依赖引入、javascript模块加载、资源路径配置及跨域等常见问题，提供了一份完整的html代码示例，帮助开发者顺利实现codepen项目的本地化调试与开发。

在前端开发中，CodePen等在线代码编辑器为快速原型设计和分享提供了极大便利。然而，当需要将这些在线项目迁移到本地环境进行更深入的开发或调试时，开发者常会遇到一些挑战，尤其是在处理外部库、模块化脚本和资源路径方面。本文将以一个MediaPipe人脸关键点检测项目为例，详细阐述如何解决这些问题，确保项目能在本地顺利运行。

本地化CodePen项目面临的挑战

将CodePen项目直接复制粘贴到本地往往无法正常工作，主要原因包括：

外部CSS/JS库的引入方式差异： CodePen通常通过其UI界面或特定的预处理器语法（如SCSS的@use）来管理外部库。在本地，这些库需要通过标准的标签引入CSS文件，或通过
JavaScript模块化： 现代JavaScript项目广泛使用ES Modules（import/export语法）。在浏览器环境中，使用import语句的脚本必须通过
资源路径问题： 项目中引用的图片、模型文件（如MediaPipe的.task文件）或WebAssembly（WASM）文件，在CodePen上可能通过相对路径或CodePen内部机制访问。本地化时，这些资源需要确保能够被正确访问，通常意味着需要使用完整的CDN路径。
跨域资源共享（CORS）： 当项目从不同源加载图片并将其绘制到

解决方案：构建一个完整的本地HTML文件

解决上述问题的最直接方法是创建一个独立的HTML文件，将所有必要的HTML结构、CSS样式和JavaScript代码整合进去，并确保所有外部依赖都通过正确的CDN链接引入。

1. HTML结构与元数据

一个标准的HTML文件需要包含、

和标签。中应包含字符集声明、视口设置以及页面标题等基本元数据。




  
  
  
  
  Face Landmarker

2. 样式引入 (CSS Integration)

原CodePen项目可能使用了SCSS的@use "@material";来引入Material Design样式。在本地，我们应移除此SCSS语法，转而通过CDN链接直接引入Material Components Web的CSS文件。项目特有的CSS可以直接内联到

VWO

一个A/B测试工具

下载


  
  Face Landmarker

3. 脚本引入 (JavaScript Integration)

JavaScript部分是本地化过程中最容易出错的地方。

首先，Material Components Web的JavaScript库也需要通过CDN链接引入。
其次，MediaPipe Vision库的导入必须使用
WASM文件和模型文件的路径也必须是可访问的CDN地址。
对于需要进行图像处理的标签，务必添加crossorigin="anonymous"属性。


  Face landmark detection using the MediaPipe FaceLandmarker task

  
    Demo: Detecting Images
    Click on an image below to see the key landmarks of the face.

    
      
      @@##@@
    
    
      
    

    Demo: Webcam continuous face landmarks detection
    Hold your face in front of your webcam to get real-time face landmarker detection.
Click enable webcam below and grant access to the webcam if prompted.

相关专题

js获取数组长度的方法

在js中，可以利用array对象的length属性来获取数组长度，该属性可设置或返回数组中元素的数目，只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值，也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容，供大家免费下载使用。

557

2023.06.20

js刷新当前页面

js刷新当前页面的方法：1、reload方法，该方法强迫浏览器刷新当前页面，语法为“location.reload([bForceGet]) ”；2、replace方法，该方法通过指定URL替换当前缓存在历史里（客户端）的项目，因此当使用replace方法之后，不能通过“前进”和“后退”来访问已经被替换的URL，语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

394

2023.07.04

js四舍五入

js四舍五入的方法：1、tofixed方法，可把 Number 四舍五入为指定小数位数的数字；2、round() 方法，可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

754

2023.07.04

js删除节点的方法

js删除节点的方法有：1、removeChild()方法，用于从父节点中移除指定的子节点，它需要两个参数，第一个参数是要删除的子节点，第二个参数是父节点；2、parentNode.removeChild()方法，可以直接通过父节点调用来删除子节点；3、remove()方法，可以直接删除节点，而无需指定父节点；4、innerHTML属性，用于删除节点的内容。

478

2023.09.01

JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号，可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容，供大家免费下载体验。

454

2023.09.04

js生成随机数的方法

js生成随机数的方法有：1、使用random函数生成0-1之间的随机数；2、使用random函数和特定范围来生成随机整数；3、使用random函数和round函数生成0-99之间的随机整数；4、使用random函数和其他函数生成更复杂的随机数；5、使用random函数和其他函数生成范围内的随机小数；6、使用random函数和其他函数生成范围内的随机整数或小数。

1031

2023.09.04

如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍：1、内联脚本是将JavaScript代码直接嵌入到HTML标签中；2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中；3、外部脚本是将JavaScript代码放置在一个独立的文件；4、外部脚本是将JavaScript代码放置在一个独立的文件。

658

2023.09.12

Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型，用于表示独一无二的值。Symbol的特点：1、独一无二，每个Symbol值都是唯一的，不会与其他任何值相等；2、不可变性，Symbol值一旦创建，就不能修改或者重新赋值；3、隐藏性，Symbol值不会被隐式转换为其他类型；4、无法枚举，Symbol值作为对象的属性名时，默认是不可枚举的。

554

2023.09.20