最常见原因是模块路径未正确配置，需检查python的sys.path、当前工作目录及tsconfig.json设置，确保解释器路径一致、源码路径映射准确、语言服务缓存已刷新。
Python 中 import 后调不到另一个文件的函数
最常见原因是模块路径没对上，VS Code 本身不决定 import 能否成功，真正起作用的是 Python 解释器的 sys.path 和当前工作目录。VS Code 只负责把代码发给解释器执行，它不会自动帮你“理解项目结构”。
实操建议：
- 确认你在终端里运行
python main.py时是否也报ModuleNotFoundError—— 如果也报，问题不在 VS Code，在 Python 环境本身 - 检查 VS Code 底部状态栏右下角显示的 Python 解释器路径，是否和你在终端里
which python或where python查到的一致 - 在 VS Code 终端中执行
pwd（macOS/Linux）或cd（Windows），看当前工作目录是不是你期望的项目根目录；不是的话，用cd切过去再运行 - 如果项目有
__init__.py，确保它存在且为空或只含合法语句；缺失会导致子目录不被视为包
JavaScript/TypeScript 中 VS Code 提示“Cannot find name 'xxx'”
这是 TypeScript 类型检查报错，不是运行时错误。VS Code 的 IntelliSense 依赖 tsconfig.json 配置来确定哪些文件该被包含、如何解析路径。
实操建议：
- 检查项目根目录是否有
tsconfig.json；没有就运行tsc --init生成一个基础配置 - 确认
tsconfig.json中的"include"字段是否覆盖了你要 import 的文件，比如["src/**/*"]，而不是只写["src/index.ts"] - 如果用了路径别名（如
import { foo } from '@utils/helper'），必须在tsconfig.json中配好"baseUrl"和"paths"，否则 VS Code 不知道去哪找 - 重启 TS Server：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入 “TypeScript: Restart TS server”，回车
VS Code 调试时断点不生效，函数明明 import 了却跳不进去
断点失效往往是因为调试器没加载到目标文件的 sourcemap 或源码路径映射错了，尤其在打包（webpack/vite）或跨目录引用时。
TURF(开源)权限管理系统
下载
TURF（开源）权限定制管理系统（以下简称“TURF系统”），是蓝水工作室推出的一套基于软件边界设计理念研发的具有可定制性的权限管理系统。TURF系统充分考虑了易用性，将配置、设定等操作进行了图形化设计，完全在web界面实现，程序员只需在所要控制的程序中简单调用一个函数，即可实现严格的程序权限管控，管控力度除可达到文件级别外，还可达到代码级别，即可精确控制到
实操建议：
- 检查
.vscode/launch.json中的"sourceMaps"是否设为true（Node.js 调试必需） - 确认
"outFiles"配置是否匹配你的编译输出路径，比如["${workspaceFolder}/dist/**/*.js"] - 如果被调用的函数在另一个 workspace 文件夹里（多根工作区），确保那个文件夹已添加进当前 workspace，并且其
package.json或构建配置没屏蔽源码 - 临时在函数开头加一句
debugger;，看运行时是否真的进了这个函数——排除逻辑没走到的可能
为什么改了函数内容，VS Code 里还是旧提示？
VS Code 的语言服务缓存很顽固，尤其是 TypeScript 和 Python（Pylance）。它不会实时监听所有文件变更，特别是符号重命名、跨文件导出更新这类操作。
实操建议：
- 保存所有相关文件后，手动触发重载：按
Ctrl+Shift+P→ 输入 “Developer: Reload Window” - Python 用户可尝试关闭 Pylance，改用默认的 Jedi（在设置里搜
python.languageServer，改成Jedi），对比是否缓解 - TypeScript 用户可在
tsconfig.json中加"forceConsistentCasingInFileNames": true，避免大小写混用导致缓存错乱 - 删掉
.vscode/settings.json里可能干扰的typescript.preferences.*或python.defaultInterpreterPath手动硬编码项，让 VS Code 自动探测
跨文件调用的本质是环境可见性 + 工具链配置一致性。VS Code 是个聪明的编辑器，但不是万能的调度中心；它看到什么，取决于你告诉解释器和语言服务器什么。最容易被忽略的，其实是终端里 pwd 输出的那行路径，和 python -c "import sys; print(sys.path)" 打印出的第一项——这两个地方不对，其他全白搭。
